yt-retention — Claude Code skill: what it does, how to install
yt-retention is a Claude Code skill that analyzes YouTube Studio audience-retention exports to locate viewer drop-offs and suggest script fixes.
MIT 1,400 installs ★ 6,796 updated 2026-09-16
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-codeWhat yt-retention does
The skill reads retention CSV data and correlates audience drops with timestamps via the python3 retention.py script. It categorizes issues into early hook loss, sudden cliffs from topic shifts or sponsors, and steady pacing slides across the middle. Running the script requires Python and optionally a .srt transcript file for detailed phrasing analysis.
The agent highlights the single biggest leak and one concrete fix. If the hook is healthy and the slide is flat, it points out packaging issues and routes to /yt-package. Every run concludes with a confirmation prompt asking whether to ship or change the video.
What it helps with
- locate viewer loss in the first thirty seconds
- identify steep drop-offs on the retention graph
- analyze steady audience bleed across the middle
- match retention cliffs to transcript lines
Example prompts for the agent
- Analyze audience retention in retention.csv
- My retention is bad around minute ten, find out why
- Fix my pacing using this YouTube Studio CSV export
How to install yt-retention
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-code2Manually: put the files in place
~/.claude/skills/yt-retention/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/yt-retention/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a codex2Manually: put the files in place
.agents/skills/yt-retention/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a cursor2Manually: put the files in place
.cursor/skills/yt-retention/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jakeschincariol/youtube-agent-skill skills/yt-retention2Manually: put the files in place
.github/skills/yt-retention/SKILL.md1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jakeschincariol/youtube-agent-skill --path skills/yt-retentionManually: put the files in place
.devin/skills/yt-retention/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -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-retention
How to install yt-retention in Claude Code?
Run npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-code, then reference ~/.claude/skills/yt-retention/SKILL.md.
What does yt-retention do?
It reads YouTube Studio audience-retention exports, runs a Python analysis script, and pinpoints exact moments where viewers leave.
What is needed to run yt-retention?
Running the underlying script requires Python.
Source text
SKILL.md · MIT
--- name: yt-retention description: >- Read a YouTube Studio audience-retention export and find where viewers actually leave, then say what to change. Use for "why do people stop watching", "my retention is bad", a pasted retention chart or CSV, or "fix my pacing". --- # yt-retention The retention graph is the only honest feedback YouTube gives you. Almost nobody exports it. ```bash python3 retention.py retention.csv --duration 600 python3 retention.py retention.csv --transcript transcript.srt ``` Getting the file: Studio -> a video -> Analytics -> Engagement -> the audience-retention chart -> the download icon -> "Audience retention". ## Three different problems - **HOOK LEAK** - what is lost in the first 30 seconds. Under 25% is healthy. This is always the first thing to fix and it is always the first fifteen seconds of script, never the edit. - **CLIFFS** - single steep drops. A cliff is a moment: a topic change with no signposting, a sponsor read, a long setup. With `--transcript` the tool prints what was being said there, which is what makes the report actionable instead of interesting. - **SLIDE** - the steady bleed across the middle. A flat slide is pacing. The fix is cutting, not rewriting. ## What to hand back Name the single biggest leak and one change for it. Not a list of five. Then, only if asked, the rest. And if the hook leak is healthy and the slide is flat, say the video is fine and the problem is packaging - send them to `/yt-package`. ## 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