---
name: gog-youtube
description: "YouTube operations through gog."
---

# YouTube

<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->

Use `gog` for YouTube operations. Read `../gog/SKILL.md` first for shared auth,
output, safety, and live-write rules.

## Safe start

```bash
gog auth list --check --json --no-input
gog schema youtube --json
gog --readonly --account user@example.com youtube --help
```

- Select the account explicitly with `--account`.
- Use `--json --wrap-untrusted` for agent-readable Google content.
- Use `--readonly` when the task must not mutate Google data.
- Use `--no-input` in automation and `--dry-run` before supported writes.
- Confirm the exact account, object, and mutation before any write or delete.

## Commands

| Command | Purpose |
| --- | --- |
| `activities` | List channel activities |
| `channels` | List channels |
| `comments` | List comment threads |
| `playlists` | Manage playlists |
| `search` | Search YouTube for videos, channels, or playlists |
| `subscriptions` | Manage channel subscriptions |
| `videos` | List or get videos |

Run `gog youtube <command> --help` for flags and `gog schema youtube <command> --json`
for the machine-readable contract. Do not guess command syntax.