yt-audit — Claude Code skill: what it does, how to install
yt-audit is a Claude Code skill that reviews a YouTube channel through titles, thumbnails, the first fifteen seconds, and retention. It starts from an audit request or a pasted channel URL.
MIT 1,300 installs ★ 6,796 updated 2026-09-16
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-codeWhat yt-audit does
yt-audit reviews a YouTube channel by examining its titles, thumbnails, opening fifteen seconds, upload consistency, and retention shape. The result selects one main fix for the week, names three elements that already work, and marks changes to postpone.
The skill reads ~/.claude/youtube/voice.md when that file exists. If it does not, three videos made by the channel owner are needed: yt-audit reads or transcribes them, infers the creator’s voice, and writes the profile. Titles go through ../yt-package/title.py; opening sections are scored with ../yt-script/hookscore.py; retention data is taken through /yt-retention when it can be exported.
The audit does not publish anything. Each result ends with a copyable block and the question “ship it, or change it?”. Without ~/.claude/youtube/voice.md, the skill uses three of the owner’s videos to build the voice context.
What it helps with
- compare the last ten titles as one set
- spot thumbnails that fail at feed size
- score the opening fifteen seconds of three recent videos
- check whether uploads follow a consistent rhythm
- choose one fix for this week
Example prompts for the agent
- Audit my channel.
- Why isn't my channel growing?
- Review my videos and tell me what to fix first.
How to install yt-audit
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-code2Manually: put the files in place
~/.claude/skills/yt-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/yt-audit/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a codex2Manually: put the files in place
.agents/skills/yt-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a cursor2Manually: put the files in place
.cursor/skills/yt-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jakeschincariol/youtube-agent-skill skills/yt-audit2Manually: put the files in place
.github/skills/yt-audit/SKILL.md1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jakeschincariol/youtube-agent-skill --path skills/yt-auditManually: put the files in place
.devin/skills/yt-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -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-audit
How do I install yt-audit in Claude Code?
Run npx skills add Jakeschincariol/youtube-agent-skill --skill yt-audit -a claude-code. The skill file is available at ~/.claude/skills/yt-audit/SKILL.md.
What does yt-audit do?
It examines the last ten titles, thumbnails at feed size, the first fifteen seconds of three recent videos, upload consistency, and retention shape. The output names one main fix, three things already working, and changes to leave for later.
What does yt-audit need to work?
The skill reads ~/.claude/youtube/voice.md when it exists. Otherwise, it needs three videos from the channel owner to infer the voice and create that profile.
Source text
SKILL.md · MIT
--- name: yt-audit description: >- Audit a YouTube channel end to end - packaging, consistency, the first fifteen seconds, and what to fix first. Use for "audit my channel", "why isn't my channel growing", "review my videos", or a pasted channel URL. --- # yt-audit An audit that lists twenty problems is a way of avoiding the one that matters. This ends in ONE fix. ## Before you write 1. Read `~/.claude/youtube/voice.md` if it exists. That is the user's voice profile: how they talk on camera, the words they never use, who they are talking to, what they will not claim. If it does not exist, ask for **three of their own videos**, read or transcribe them, infer the voice, and write the file. A script in the wrong voice is worse than no script, because they have to read it out loud. 2. Never invent a number, a result or a source. If a figure would strengthen it and you do not have one, ask for it or write the line without it. ## What to look at, in this order 1. **The last ten titles, as a set.** Read them as a list, the way the channel page shows them. Do they promise different things? Run them through `../yt-package/title.py`. A channel where every title is the same shape has a format problem, not a title problem. 2. **The thumbnails, at feed size.** Shrink them. What survives? If three of them are unreadable at that size, that is the fix and nothing else matters yet. 3. **The first fifteen seconds of the three most recent.** Transcribe them and score with `../yt-script/hookscore.py`. This is where most channels lose. 4. **Upload rhythm.** Not frequency - CONSISTENCY. Six videos in one week and then nothing for a month is worse than one a fortnight forever. 5. **The retention shape**, if they can export it. `/yt-retention`. ## What to hand back - The single biggest fix, named, with what to do this week. - Three things that are already working, so they do not break them. Be specific; "your energy is good" is not an observation. - What NOT to do yet, and why. Never open an audit with praise you do not mean, and never end one with a list of twenty things. ## The gate Nothing here publishes. This skill writes and you publish. Every output ends in a block the user copies, and the last line of every run is the question: **ship it, or change it?**
© Jakeschincariol · MIT · Jakeschincariol/youtube-agent-skill