yt-master — Claude Code skill: YouTube planning and metrics
yt-master — a skill for YouTube work: sharpens the idea, title, thumbnail concept and script, then reads the metrics when views or CTR slip.
no license 128 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill yt-master -a claude-codeWhat yt-master does
The skill deals in decisions, not files: which angle to take, whether the title and thumbnail carry one promise, whether the script holds attention, where the channel is heading. Each request is routed to its own reference: ideas in references/piramide-e-ideia.md, packaging in references/titulos.md and references/thumbnails.md, script and retention in references/roteiro-e-retencao.md, CTR and distribution in references/algoritmo-e-ctr.md. A video brief template and a pre-publish checklist sit alongside.
Two helper scripts return advisory signals. python3 <yt-master-dir>/scripts/title-check.py "<title>" flags formulaic patterns in a title; python3 <yt-master-dir>/scripts/ctr-baseline.py --impressoes <n> --cliques <n> --baseline <percent> returns CTR and the gap from a baseline you supply. Neither one forecasts how a video will do. Without python3 on the machine there are no signals at all.
Metric diagnosis stays tied to a comparable audience, format, traffic source and time window, since a small impression count on its own says nothing about a thumbnail. Cutting footage, rendering thumbnail pixels and uploading through the API are outside the skill and need other tools. Benchmarks and platform features are kept as dated examples, so check the current official guidance before trusting any threshold.
What it helps with
- line up a title and thumbnail around one promise
- rewrite a script that loses viewers halfway
- read a CTR drop against a comparable window
- pick an upload cadence you can keep
- scan a title for formulaic patterns
Example prompts for the agent
- Give me three angles for a video about moving to
postgres, each with a promise the script can deliver - Go through this script: where does retention sag, and which hooks need rewriting?
- Run
scripts/ctr-baseline.py --impressoes <n> --cliques <n> --baseline <percent>and explain the gap from my baseline
How to install yt-master
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill yt-master -a claude-code2Manually: put the files in place
~/.claude/skills/yt-master/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/yt-master/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill yt-master -a codex2Manually: put the files in place
.agents/skills/yt-master/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill yt-master -a cursor2Manually: put the files in place
.cursor/skills/yt-master/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/yt-master2Manually: put the files in place
.github/skills/yt-master/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill yt-master -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/yt-masterManually: put the files in place
.devin/skills/yt-master/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill yt-master -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about yt-master
How do I install yt-master in Claude Code?
Run npx skills add pedronauck/skills --skill yt-master -a claude-code. The skill lands at ~/.claude/skills/yt-master/SKILL.md.
What does yt-master do?
It plans and improves ideas, titles, thumbnail concepts, scripts and channel strategy, and diagnoses performance metrics against comparable data.
Do I need Python for yt-master?
Yes, both helper scripts run through python3. Their output is pattern hints and CTR arithmetic, not a prediction of views.