ericrisco/rsc-harness / skills/youtube-api
youtube-api
VerifiedUse when wiring code to a real YouTube channel: user OAuth 2.0, resumable videos.insert uploads, editing metadata after publish, pulling views/watch time/retention/traffic from the Analytics API v2 into a dated 02-DOCS/wiki/youtube/ feedback log. NOT what to publish or how to title and thumbnail it (that is youtube-strategy / youtube-packaging).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.5 KB |
| evals/README.md | markdown | 894 B |
| evals/cases.yaml | config | 3.7 KB |
| references/analytics-queries.md | markdown | 4.0 KB |
| references/oauth-setup.md | markdown | 3.7 KB |
| references/wiki-schema.md | markdown | 4.9 KB |
| scripts/verify.shexecutable | script | 3.6 KB |
evals/cases.yaml
View on GitHubskill: youtube-api
should_trigger:
- prompt: "Upload a video to my YouTube channel via the API and set its title and tags."
why: "Core write path — videos.insert + metadata. The transport job this skill owns."
- prompt: "My YouTube refresh token stops working after about a week — why?"
why: "Non-obvious: app left in Testing publishing status issues 7-day refresh tokens; this skill maps that symptom to the In-production fix."
- prompt: "Pull the averageViewPercentage and the audience-retention curve for video abc123."
why: "Analytics read path — elapsedVideoTimeRatio + audienceWatchRatio. Squarely this skill."
- prompt: "subir vídeos a YouTube por API y guardar las estadísticas del canal."
why: "Spanish; upload + ingest stats — the full transport + ingestion loop this skill owns."
- prompt: "videos.insert returns 403 quotaExceeded — how many uploads does the 10k unit quota allow?"
why: "Quota math, and a teachable premise correction: uploads use a separate ~100 videos.insert/day call cap, not the shared 10k unit pool (official docs, Last updated 2026-06-01 UTC). Debugging the Data API, this skill's domain."
- prompt: "Fetch this month's traffic sources and write them into 02-DOCS/wiki/youtube/."
why: "The ingestion deliverable: insightTrafficSourceType report appended to the channel feedback log."
- prompt: "I keep getting uploadLimitExceeded even though I have quota units left."
why: "Non-obvious separate daily upload-count cap distinct from unit quota — this skill explains the throttle-count rule."
should_not_trigger:
- prompt: "What kind of videos should my channel make to grow this quarter?"
route_to: youtube-strategy
why: "Growth plan / niche / cadence is strategy; this skill only delivers the numbers, it does not set the plan."
- prompt: "Write me 5 high-CTR title and thumbnail text options for this video."
route_to: youtube-packaging
why: "Packaging/CTR copy. This skill fetches CTR; it does not write the title that lifts it."
- prompt: "Brainstorm 20 video ideas for my cooking niche."
route_to: youtube-ideation
why: "Idea generation, no API or ingestion involved."
- prompt: "Post this clip to Instagram, TikTok, and YouTube at the same time."
route_to: social-publisher
why: "Multi-network cross-posting; this skill is YouTube-only and deep on its two APIs."
- prompt: "Render the actual video file in code so I can upload it."
route_to: remotion-video
why: "Video production/rendering, not transport."
- prompt: "Wrap a generic REST API I picked with OAuth and retry/backoff."
route_to: api-connector-builder
why: "Arbitrary-provider connector; this skill is specific to YouTube's Data + Analytics APIs."
capability:
- scenario: "Build a weekly cron that authenticates to a YouTube channel, fetches channel KPIs plus the retention curve and traffic sources for the latest video, and appends a dated entry to 02-DOCS/wiki/youtube/."
must_include:
- "User OAuth 2.0 flow (not a service account) with a persisted, refreshable token"
- "Note that the OAuth consent screen must be 'In production' or refresh tokens die in ~7 days"
- "Analytics query using ids=channel==MINE with metrics including averageViewPercentage"
- "Retention via dimensions=elapsedVideoTimeRatio and metrics audienceWatchRatio"
- "Traffic via dimensions=insightTrafficSourceType"
- "Least-privilege scopes (yt-analytics.readonly, not full auth/youtube)"
- "Append-not-overwrite dated wiki entry with frontmatter (date/range/channel)"
- "Exponential backoff with jitter on 403 quotaExceeded / 429"
- "Never commit client_secret.json or token.json"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |