Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-retention -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/yt-retention/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/yt-retention/

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

Similar skills

All skills for Marketing and content →

From the same set11

The whole set →
yt-script The yt-script Claude Code skill turns a video idea into a YouTube script and scores possible hooks. The agent uses it for requests to draft a video, an opening line, or a hook. CX Codex +1 1,400installs yt-plan yt-plan — a skill for Claude Code plans a week or month of YouTube uploads around available hours and work already in progress. It assigns formats and publishing days. CX Codex +1 1,300installs yt-audit 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. CX Codex +1 1,300installs yt-chapters The yt-chapters Claude Code skill turns a transcript into YouTube chapters. Ask for timestamps or a video split into sections to trigger it. CX Codex +1 1,300installs yt-edit yt-edit — a skill for Claude Code that converts video transcripts into an edit decision list. It identifies timestamps for removing dead air, filler words, and retakes. CX Codex +1 1,300installs yt-seo The yt-seo Claude Code skill writes YouTube descriptions and tags around real search queries. It checks whether the title and opening lines use the terms viewers search for. CX Codex +1 1,300installs yt-shorts yt-shorts — a Claude Code skill that scans long video transcripts to extract standalone segments and write Shorts scripts. It triggers on requests to clip or repurpose videos. CX Codex +1 1,300installs yt-viral The yt-viral Claude Code skill ranks YouTube videos by views relative to their channel’s median. It surfaces title formulas and patterns across videos in a niche. CX Codex +1 1,300installs

Project sponsors

Companies that keep this analytics open