YouTube Channel Operator
Build a channel-agnostic YouTube operations core with two interfaces:
- typed raw API methods for trusted power users;
- guided workflows that resolve exact resources, preview a change set, and apply it after approval.
Use slackbot-builder for Slack transport maturity and data-chatbots for
proposal/apply semantics. Use this skill for the YouTube-specific domain layer
that joins them.
The one rule
Raw and guided operations must share one deterministic executor.
The model may choose an operation and draft parameters. It must never construct
authorization, call arbitrary URLs, or independently decide what was applied.
The server resolves the account and resource, builds the provider request,
persists the exact reviewed action, applies it once, and verifies the result.
Route the task
| Need |
Load |
| Determine whether an operation exists, its scope, quota, or API limitation |
references/capabilities.md |
| Design OAuth accounts, raw tools, proposals, execution, idempotency, or audit |
references/architecture.md |
| Implement common Slack workflows and approval cards |
references/slack-playbooks.md |
| Download captions or generate summaries, chapters, clips, quotes, and titles |
references/transcripts.md |
| Measure performance after title, thumbnail, description, or playlist changes |
references/analytics-experiments.md |
| Reconcile paid reach, organic lift, subscriber quality, and Google Ads evidence |
references/analytics-experiments.md |
| Run recurring canonical-link, event, sponsor, or other description/comment CTA campaigns |
references/cta-campaigns.md |
| Build or review the test matrix |
references/test-cases.md |
Do not load every reference automatically.
Distinguish the three execution surfaces
| Surface |
Use it for |
| Official API |
Stable reads and writes: metadata, thumbnails, captions, comments, playlists, channel layout, uploads, live, analytics, reporting |
| Studio/browser |
Native title/thumbnail A/B tests, pinning comments, Community posts, end screens/cards, Studio editor, Shorts thumbnail frames, and other undocumented controls |
| Local atomic skill |
One-off scriptable uploads, thumbnail sets, metadata changes, and channel listing through youtube-api |
Never claim an MCP or private endpoint can perform a Studio-only action unless
the owning UI is actually controlled and verified.
Non-negotiable invariants
- Pin the account. Map an immutable account key to one expected channel ID
and one credential namespace. Verify
channels.list(mine=true) before
drafting and applying.
- Isolate channels. Use separate OAuth grants and secrets per brand/channel.
Never infer routing from a title or reuse one channel's refresh token.
- Expose methods, not arbitrary HTTP. Raw tools accept a registered method
ID, typed parameters, body, and optional immutable media asset. Reject custom
URLs, hosts, headers, tokens, or an unreviewed
execute flag.
- Use full metadata for content work. Treat catalogs, search hits, and
descriptionExcerpt fields as discovery records only. After resolving exact
video IDs, fetch videos.list(part=snippet,...) and use the complete
snippet.description before extracting, comparing, or rewriting content.
Never conclude text is absent because it is absent from an excerpt. YouTube
detail reads should use 50-video pages to match YouTube's native request
limit and continue larger sets with an explicit page or cursor.
YouTube update endpoints use replacement semantics for included parts, so
merge a patch into the full current mutable part and review the complete
outgoing representation.
- Apply exactly what was reviewed. Persist the exact resource ID, base
ETag, before state, desired patch, normalized provider request, actor, and
expiry. If live state drifts, conflict and create a fresh proposal.
- Keep Slack thin. Verify/ack/dedupe/render in Slack; resolve, validate,
persist, execute, and audit in a channel-agnostic core.
- Make external writes durable. Use a workflow or queue for uploads,
scheduled rotations, multi-step packages, retries, and analytics follow-ups.
- Verify the owning surface. Refetch the resource after every API mutation.
For Studio-only work, reopen the exact Studio/video record.
- Keep immutable audit history. Record the actual human proposer and
approver, provider/account, exact request, before/after, attempts, and outcome.
Never store OAuth tokens or Authorization headers in D1, logs, traces, or Slack.
- Separate change proof from performance impact. A successful write proves
state changed. Analytics later describe correlation, not causality, unless
YouTube's native concurrent experiment supplies the result.
- Separate acquisition objectives and evidence. Cheap paid views can be a
valid awareness outcome. Report paid reach, organic behavior, attributed
subscribers, and repeat engagement separately; do not collapse them into a
single quality score or dismiss inexpensive views by default.
Build the two capability layers
Raw power-user layer
Expose a compact typed surface:
youtube.data.call
youtube.live.call
youtube.analytics.query
youtube.reporting.call
youtube.transcript.get
Require accountKey, a registered method ID, exact IDs/parameters, a validated
body, and an optional immutable asset ID. Show the normalized provider request
before execution. Keep the method registry complete even when common workflows
cover only a subset. youtube.transcript.get is a read-only convenience tool
over registered captions.list and captions.download calls; it must preserve
the selected caption track and timestamps rather than scrape watch-page HTML.
Guided workflow layer
Promote frequently repeated operations into domain workflows:
- title/thumbnail candidate package;
- complete video metadata refresh;
- create or update the channel-owned top-level comment;
- playlist create/update/add/remove/reorder/shelf;
- upload package with thumbnail, captions, playlists, scheduling, and comment;
- scheduled-release batch for already uploaded unpublished videos;
- caption download and transcript-derived summary/chapter/clip/quote package;
- comment moderation and reply queue;
- canonical-link and time-bounded CTA campaign;
- live broadcast setup and operations;
- before/after analytics checkpoints.
Each workflow lowers to the same typed raw methods. Do not maintain a second
mutation implementation.
Proposal-to-apply lifecycle
request
→ resolve exact channel + resource IDs
→ read current resource + ETag
→ validate ownership and provider constraints
→ merge full mutable API part
→ persist immutable draft + idempotency key
→ render before/after, effects, quota, and deep link
→ signed human approval
→ atomically claim the draft
→ refetch + reject drift
→ execute/reconcile once
→ refetch owning API
→ append audit result
→ schedule measurement checkpoints
For a multi-step package, report each step independently. YouTube does not
provide a transaction spanning metadata, thumbnail, comment, playlist, and
caption calls. Store rollback inputs, but never describe compensation as atomic.
Design the approval card
Show:
- account label and exact channel ID;
- resource kind, exact ID, URL, and current owner;
- compact before → after diff;
- API method, affected
parts, and media asset;
- irreversible or public side effects;
- idempotency/expiry and drift behavior;
- analytics baseline and planned follow-ups;
- full-review deep link when Slack truncates content.
Button values contain only an opaque proposal ID. Load all executable content
from server-side storage. Resolve buttons in place after approve, reject,
conflict, or failure.
Handle the common API gaps explicitly
- Native title/thumbnail A/B testing is Studio-only. API title/thumbnail changes
stop a running native experiment.
- Comment creation/editing is supported; pin/unpin is not.
- Community posts, end screens/cards, Studio editing, handles/avatar changes,
Shorts thumbnail-frame selection, and most VOD monetization controls are not
public Data API operations.
- Native A/B arm allocation and winner data are not exposed in Analytics or
Reporting APIs.
Offer an exact Studio handoff or supervised browser workflow. Do not silently
substitute a sequential rotation and call it a native A/B test.
Google Ads campaign creation and mutation belong to an Ads operator. This skill
may ingest Ads campaign evidence and reconcile it with YouTube analytics, but it
must not invent Ads mutation methods inside the YouTube executor.
Implementation order
- Record product decisions: account keys/IDs, Slack-to-role mapping, which
mutations require approval, public/private delivery, deterministic
channel-comment marker, native versus sequential experiment policy, media
storage, reporting windows, and any winner thresholds.
- Inventory channels, exact IDs, OAuth ownership, runtimes, and current API
grants.
- Build account routing and token refresh with fail-closed channel verification.
- Implement the typed raw method registry and read-only dry-run/normalization.
- Add a provider-neutral external-action proposal, attempt, and audit ledger.
- Add Slack/web proposal rendering and signed approval.
- Ship metadata, thumbnail, comment, and playlist guided workflows.
- Add Reporting API reach jobs and durable impact checkpoints.
- Add resumable uploads, captions, live operations, and Studio handoffs.
- Provision each additional channel independently and run live canaries.
Completion proof
Do not report the operator complete until all applicable evidence exists:
- OAuth grant stored in the intended runtime secret store;
- exact channel ID verified from the active grant;
- raw read and reversible write canary;
- approval actor and immutable audit row;
- drift conflict test;
- duplicate delivery/retry test;
- API readback or Studio owning-surface verification;
- analytics job/checkpoint proof when measurement is promised;
- paid/organic and attribution reconciliation when promotion is measured;
- refresh-token health check and explicit reauthorization failure handling;
- independent proof for every configured channel and runtime.
1---2name: youtube-channel-operator3description: Design, build, review, or extend a production YouTube channel operator that combines complete typed YouTube Data, Analytics, Reporting, and Live API access with guided Slack or chatbot workflows, human approval, durable execution, audit history, multi-channel OAuth isolation, caption downloads, transcript summaries, viewer timestamps, paid-versus-organic acquisition analysis, and post-change measurement. Use for YouTube operations bots, creator-management copilots, raw power-user API tools, transcript processing, chapters, pull quotes, clips, title or thumbnail experiments, description and comment workflows, playlist management, uploads, moderation, live operations, Google Ads/paid-promotion measurement, or analytics tied to channel changes. Hand atomic one-off API execution to youtube-api and Studio-only browser work to youtube-studio-computer-use.4metadata:5 source: https://skillmd.com/skills/swyxio/youtube-channel-operator6---78# YouTube Channel Operator910Build a channel-agnostic YouTube operations core with two interfaces:11121. typed raw API methods for trusted power users;132. guided workflows that resolve exact resources, preview a change set, and apply it after approval.1415Use `slackbot-builder` for Slack transport maturity and `data-chatbots` for16proposal/apply semantics. Use this skill for the YouTube-specific domain layer17that joins them.1819## The one rule2021**Raw and guided operations must share one deterministic executor.**2223The model may choose an operation and draft parameters. It must never construct24authorization, call arbitrary URLs, or independently decide what was applied.25The server resolves the account and resource, builds the provider request,26persists the exact reviewed action, applies it once, and verifies the result.2728## Route the task2930| Need | Load |31| --- | --- |32| Determine whether an operation exists, its scope, quota, or API limitation | [references/capabilities.md](references/capabilities.md) |33| Design OAuth accounts, raw tools, proposals, execution, idempotency, or audit | [references/architecture.md](references/architecture.md) |34| Implement common Slack workflows and approval cards | [references/slack-playbooks.md](references/slack-playbooks.md) |35| Download captions or generate summaries, chapters, clips, quotes, and titles | [references/transcripts.md](references/transcripts.md) |36| Measure performance after title, thumbnail, description, or playlist changes | [references/analytics-experiments.md](references/analytics-experiments.md) |37| Reconcile paid reach, organic lift, subscriber quality, and Google Ads evidence | [references/analytics-experiments.md](references/analytics-experiments.md) |38| Run recurring canonical-link, event, sponsor, or other description/comment CTA campaigns | [references/cta-campaigns.md](references/cta-campaigns.md) |39| Build or review the test matrix | [references/test-cases.md](references/test-cases.md) |4041Do not load every reference automatically.4243## Distinguish the three execution surfaces4445| Surface | Use it for |46| --- | --- |47| Official API | Stable reads and writes: metadata, thumbnails, captions, comments, playlists, channel layout, uploads, live, analytics, reporting |48| Studio/browser | Native title/thumbnail A/B tests, pinning comments, Community posts, end screens/cards, Studio editor, Shorts thumbnail frames, and other undocumented controls |49| Local atomic skill | One-off scriptable uploads, thumbnail sets, metadata changes, and channel listing through `youtube-api` |5051Never claim an MCP or private endpoint can perform a Studio-only action unless52the owning UI is actually controlled and verified.5354## Non-negotiable invariants55561. **Pin the account.** Map an immutable account key to one expected channel ID57 and one credential namespace. Verify `channels.list(mine=true)` before58 drafting and applying.592. **Isolate channels.** Use separate OAuth grants and secrets per brand/channel.60 Never infer routing from a title or reuse one channel's refresh token.613. **Expose methods, not arbitrary HTTP.** Raw tools accept a registered method62 ID, typed parameters, body, and optional immutable media asset. Reject custom63 URLs, hosts, headers, tokens, or an unreviewed `execute` flag.644. **Use full metadata for content work.** Treat catalogs, search hits, and65 `descriptionExcerpt` fields as discovery records only. After resolving exact66 video IDs, fetch `videos.list(part=snippet,...)` and use the complete67 `snippet.description` before extracting, comparing, or rewriting content.68 Never conclude text is absent because it is absent from an excerpt. YouTube69 detail reads should use 50-video pages to match YouTube's native request70 limit and continue larger sets with an explicit page or cursor.71 YouTube update endpoints use replacement semantics for included `part`s, so72 merge a patch into the full current mutable part and review the complete73 outgoing representation.745. **Apply exactly what was reviewed.** Persist the exact resource ID, base75 ETag, before state, desired patch, normalized provider request, actor, and76 expiry. If live state drifts, conflict and create a fresh proposal.776. **Keep Slack thin.** Verify/ack/dedupe/render in Slack; resolve, validate,78 persist, execute, and audit in a channel-agnostic core.797. **Make external writes durable.** Use a workflow or queue for uploads,80 scheduled rotations, multi-step packages, retries, and analytics follow-ups.818. **Verify the owning surface.** Refetch the resource after every API mutation.82 For Studio-only work, reopen the exact Studio/video record.839. **Keep immutable audit history.** Record the actual human proposer and84 approver, provider/account, exact request, before/after, attempts, and outcome.85 Never store OAuth tokens or Authorization headers in D1, logs, traces, or Slack.8610. **Separate change proof from performance impact.** A successful write proves87 state changed. Analytics later describe correlation, not causality, unless88 YouTube's native concurrent experiment supplies the result.8911. **Separate acquisition objectives and evidence.** Cheap paid views can be a90 valid awareness outcome. Report paid reach, organic behavior, attributed91 subscribers, and repeat engagement separately; do not collapse them into a92 single quality score or dismiss inexpensive views by default.9394## Build the two capability layers9596### Raw power-user layer9798Expose a compact typed surface:99100```text101youtube.data.call102youtube.live.call103youtube.analytics.query104youtube.reporting.call105youtube.transcript.get106```107108Require `accountKey`, a registered method ID, exact IDs/parameters, a validated109body, and an optional immutable asset ID. Show the normalized provider request110before execution. Keep the method registry complete even when common workflows111cover only a subset. `youtube.transcript.get` is a read-only convenience tool112over registered `captions.list` and `captions.download` calls; it must preserve113the selected caption track and timestamps rather than scrape watch-page HTML.114115### Guided workflow layer116117Promote frequently repeated operations into domain workflows:118119- title/thumbnail candidate package;120- complete video metadata refresh;121- create or update the channel-owned top-level comment;122- playlist create/update/add/remove/reorder/shelf;123- upload package with thumbnail, captions, playlists, scheduling, and comment;124- scheduled-release batch for already uploaded unpublished videos;125- caption download and transcript-derived summary/chapter/clip/quote package;126- comment moderation and reply queue;127- canonical-link and time-bounded CTA campaign;128- live broadcast setup and operations;129- before/after analytics checkpoints.130131Each workflow lowers to the same typed raw methods. Do not maintain a second132mutation implementation.133134## Proposal-to-apply lifecycle135136```text137request138 → resolve exact channel + resource IDs139 → read current resource + ETag140 → validate ownership and provider constraints141 → merge full mutable API part142 → persist immutable draft + idempotency key143 → render before/after, effects, quota, and deep link144 → signed human approval145 → atomically claim the draft146 → refetch + reject drift147 → execute/reconcile once148 → refetch owning API149 → append audit result150 → schedule measurement checkpoints151```152153For a multi-step package, report each step independently. YouTube does not154provide a transaction spanning metadata, thumbnail, comment, playlist, and155caption calls. Store rollback inputs, but never describe compensation as atomic.156157## Design the approval card158159Show:160161- account label and exact channel ID;162- resource kind, exact ID, URL, and current owner;163- compact before → after diff;164- API method, affected `part`s, and media asset;165- irreversible or public side effects;166- idempotency/expiry and drift behavior;167- analytics baseline and planned follow-ups;168- full-review deep link when Slack truncates content.169170Button values contain only an opaque proposal ID. Load all executable content171from server-side storage. Resolve buttons in place after approve, reject,172conflict, or failure.173174## Handle the common API gaps explicitly175176- Native title/thumbnail A/B testing is Studio-only. API title/thumbnail changes177 stop a running native experiment.178- Comment creation/editing is supported; pin/unpin is not.179- Community posts, end screens/cards, Studio editing, handles/avatar changes,180 Shorts thumbnail-frame selection, and most VOD monetization controls are not181 public Data API operations.182- Native A/B arm allocation and winner data are not exposed in Analytics or183 Reporting APIs.184185Offer an exact Studio handoff or supervised browser workflow. Do not silently186substitute a sequential rotation and call it a native A/B test.187188Google Ads campaign creation and mutation belong to an Ads operator. This skill189may ingest Ads campaign evidence and reconcile it with YouTube analytics, but it190must not invent Ads mutation methods inside the YouTube executor.191192## Implementation order1931941. Record product decisions: account keys/IDs, Slack-to-role mapping, which195 mutations require approval, public/private delivery, deterministic196 channel-comment marker, native versus sequential experiment policy, media197 storage, reporting windows, and any winner thresholds.1982. Inventory channels, exact IDs, OAuth ownership, runtimes, and current API199 grants.2003. Build account routing and token refresh with fail-closed channel verification.2014. Implement the typed raw method registry and read-only dry-run/normalization.2025. Add a provider-neutral external-action proposal, attempt, and audit ledger.2036. Add Slack/web proposal rendering and signed approval.2047. Ship metadata, thumbnail, comment, and playlist guided workflows.2058. Add Reporting API reach jobs and durable impact checkpoints.2069. Add resumable uploads, captions, live operations, and Studio handoffs.20710. Provision each additional channel independently and run live canaries.208209## Completion proof210211Do not report the operator complete until all applicable evidence exists:212213- OAuth grant stored in the intended runtime secret store;214- exact channel ID verified from the active grant;215- raw read and reversible write canary;216- approval actor and immutable audit row;217- drift conflict test;218- duplicate delivery/retry test;219- API readback or Studio owning-surface verification;220- analytics job/checkpoint proof when measurement is promised;221- paid/organic and attribution reconciliation when promotion is measured;222- refresh-token health check and explicit reauthorization failure handling;223- independent proof for every configured channel and runtime.