Read a YouTube Studio audience-retention export and find where viewers actually leave, then say what to change.

MITAuto-check passedDocuments & Office

Install Yt Retention

skills CLI
$ npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Jakeschincariol/youtube-agent-skill yt-retention --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Jakeschincariol/youtube-agent-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/yt-retention .claude/skills/yt-retention && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yt-retention
GitHub stars
933
Token cost
~424 tokens
SKILL.md length
215 words
Files
2
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Read a YouTube Studio audience-retention export and find where viewers actually leave, then say what to change.

  • Why do people stop watching
  • SKILL.md covers Three different problems, What to hand back and The gate
  • Runs Python scripts from its folder; calls python3
  • My retention is bad

What it does

Yt Retention is an agent skill from Jakeschincariol/youtube-agent-skill. 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".

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `retention.py`).

It sits in Documents & Office, covering CSV and tabular files. It works with YouTube. The repository describes itself as: Eleven Claude skills that run a YouTube channel: scripts off 21 hook formulas with a scored hook, title and thumbnail linted as one pairing, an edit decision list from your… The licence is MIT.

When your agent uses it

  • Why do people stop watching
  • My retention is bad
  • A pasted retention chart

Example prompts

  • “why do people stop watching”
  • “my retention is bad”
  • “fix my pacing”
  • “/yt-retention”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit a2feb21. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yt Retention loads about 424 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~424

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Jakeschincariol/youtube-agent-skill at commit a2feb21, republished under its MIT licence (© Jakeschincariol). 215 words, ~424 tokens.

Download SKILL.mdSave it as .claude/skills/yt-retention/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/yt-retention of Jakeschincariol/youtube-agent-skill.

  • SKILL.md
  • retention.py

Open the folder on GitHubat commit a2feb21

Compare with similar skills

Yt Retention next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yt Retention compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yt Retention this skillJakeschincariol/youtube-agent-skill933—~424Automated safety check: PassMIT
Gbro Series Vocabpyang5166/gbro-series-vocab163—~1.1kAutomated safety check: PassMIT
Markdown Converterintellectronica/agent-skills2954 repos~492Automated safety check: PassCC0-1.0
Overseas Trending Searchredfox-data/redfox-community427—~1.4kAutomated safety check: PassNone
To MarkdownMathews-Tom/armory329—~2kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • Gbro Series Vocab

    pyang5166/gbro-series-vocab

    追剧学英语 / Learn English vocabulary from TV series. An agent skill from pyang5166/gbro-series-vocab.

    163 GitHub stars~1.1k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markdown Converter

    intellectronica/agent-skills

    Convert documents and files to Markdown using markitdown. An agent skill from intellectronica/agent-skills.

    295 GitHub starsUsed in 4 repos~492 tokens
    Documents & OfficeAuto-check passed
  • Overseas Trending Search

    redfox-data/redfox-community

    海外跨平台热文搜索 — 输入任意关键词(中文/英文),一次搜索 X / TikTok / YouTube 三平台热门内容,每平台 Top N(默认5)统一列表(平台/标题/作者/播放/点赞/评论/发布时间/链接),终端分组表格 + CSV 导出 + 交互式 HTML…

    427 GitHub stars~1.4k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • To Markdown

    Mathews-Tom/armory

    Convert any file or URL to clean Markdown: PDF, DOCX, XLSX, PPTX, HTML, images (OCR), audio, CSV, YouTube.

    329 GitHub stars~2k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed

More from Jakeschincariol/youtube-agent-skill

All 11 skills in this repo
  • Yt Package

    Jakeschincariol/youtube-agent-skill

    Write and lint the title and thumbnail for a YouTube video as one pairing, checking truncation, duplication and vagueness before publish.

    933 GitHub stars~576 tokensUpdated 24 days ago
    Auto-check passed
  • Yt Script

    Jakeschincariol/youtube-agent-skill

    Write a YouTube video script from a raw idea - hook options off 21 formulas, scored, then the full spoken script with the retention beats marked.

    933 GitHub stars~672 tokensUpdated 24 days ago
    Auto-check passed
  • Yt Chapters

    Jakeschincariol/youtube-agent-skill

    Write YouTube chapters from a transcript, validated against YouTube's own rules so they actually render.

    933 GitHub stars~345 tokensUpdated 24 days ago
    Auto-check passed
  • Yt Edit

    Jakeschincariol/youtube-agent-skill

    Turn a raw recording's transcript into an edit decision list - dead air, filler cues and retakes, with timecodes.

    933 GitHub stars~410 tokensUpdated 24 days ago
    Auto-check passed
  • Yt Viral

    Jakeschincariol/youtube-agent-skill

    Find what is actually working in the user's niche on YouTube and rank it by how far each video beat its own channel, then name the formula.

    933 GitHub stars~437 tokensUpdated 24 days ago
    Auto-check passed
  • Yt Audit

    Jakeschincariol/youtube-agent-skill

    Audit a YouTube channel end to end - packaging, consistency, the first fifteen seconds, and what to fix first.

    933 GitHub stars~582 tokensUpdated 24 days ago
    Auto-check passed

Works with

Questions about Yt Retention

What does Yt Retention do?

Read a YouTube Studio audience-retention export and find where viewers actually leave, then say what to change. Yt Retention is an agent skill from Jakeschincariol/youtube-agent-skill. Read a YouTube Studio audience-retention export and find where viewers actually leave, then say what to change.

When should I use Yt Retention?

Yt Retention fits situations like: why do people stop watching; my retention is bad; A pasted retention chart.

How do I install Yt Retention in Claude Code?

Run `npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-code`. Or copy the skill folder (skills/yt-retention in Jakeschincariol/youtube-agent-skill) into .claude/skills/yt-retention in your project. Claude Code loads it when a task matches its description.

How do I install Yt Retention in Codex?

Run `npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a codex`. Or copy the skill folder (skills/yt-retention in Jakeschincariol/youtube-agent-skill) into .agents/skills/yt-retention in your project. Codex loads it when a task matches its description.

Can I use Yt Retention in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yt-retention, .gemini/skills/yt-retention, .github/skills/yt-retention and .opencode/skills/yt-retention in your project.

What does Yt Retention need to run?

Going by SKILL.md and its folder, Yt Retention needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Yt Retention access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yt Retention safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Yt Retention use?

Yt Retention is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yt Retention use?

About 424 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yt Retention?

Skills that share tags, products or a category with Yt Retention: Gbro Series Vocab (pyang5166/gbro-series-vocab, 163 stars), Markdown Converter (intellectronica/agent-skills, 295 stars), Overseas Trending Search (redfox-data/redfox-community, 427 stars) and To Markdown (Mathews-Tom/armory, 329 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yt Retention?

Jakeschincariol (a GitHub user) maintains it in Jakeschincariol/youtube-agent-skill, which has 933 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 16, 2026.

Source: Jakeschincariol/youtube-agent-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.