yt-chapters — Claude Code skill for YouTube 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.
MIT 1,300 installs ★ 6,796 updated 2026-09-16
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a claude-codeWhat yt-chapters does
The skill suggests chapter boundaries by looking at pauses and shifts in vocabulary. Run python3 chapters.py transcript.srt --target 8 to process transcript.srt with a target of 8 chapters.
Its proposed titles are drafts: rewrite each as a three-to-five-word promise of that section. The skill checks that the first timestamp is 00:00, the list has at least three chapters, and each one lasts 10 seconds or more. It outputs a block to copy; it does not publish the chapters.
What it helps with
- split a video transcript into chapters
- spot topic changes using pauses and vocabulary shifts
- check timestamps against YouTube chapter rules
- create a chapter block for a video description
Example prompts for the agent
- Create YouTube chapters from
transcript.srt. - Add timestamps to this video using its transcript.
- Split this video into sections and validate the chapter list.
How to install yt-chapters
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a claude-code2Manually: put the files in place
~/.claude/skills/yt-chapters/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/yt-chapters/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a codex2Manually: put the files in place
.agents/skills/yt-chapters/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a cursor2Manually: put the files in place
.cursor/skills/yt-chapters/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jakeschincariol/youtube-agent-skill skills/yt-chapters2Manually: put the files in place
.github/skills/yt-chapters/SKILL.md1Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jakeschincariol/youtube-agent-skill --path skills/yt-chaptersManually: put the files in place
.devin/skills/yt-chapters/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -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-chapters
How do I install yt-chapters in Claude Code?
Run npx skills add Jakeschincariol/youtube-agent-skill --skill yt-chapters -a claude-code. The skill file is at ~/.claude/skills/yt-chapters/SKILL.md.
What does yt-chapters do?
It proposes YouTube chapters from a transcript, checks their timestamps against YouTube’s rules, and produces a block to copy. Publishing is a separate step.
What chapter rules does yt-chapters validate?
The opening chapter must start at 00:00, the list needs at least three entries, and every chapter must last at least 10 seconds.
Source text
SKILL.md · MIT
--- name: yt-chapters description: >- Write YouTube chapters from a transcript, validated against YouTube's own rules so they actually render. Use for "add chapters", "timestamps", "break this video into sections". --- # yt-chapters ```bash python3 chapters.py transcript.srt --target 8 ``` ## The rules, which are not optional A chapter list that breaks any of these silently does not become chapters at all - the block just sits in the description doing nothing: - The first entry must be **00:00**. - There must be **at least three**. - Each must be **at least 10 seconds** long. The tool checks all three and tells you when a list is invalid rather than letting you paste it. ## Retitle every line `chapters.py` finds the BOUNDARIES well - it scores the pauses you actually took by how much the vocabulary shifts across them. The titles it emits are the topic words, and they are a draft. A chapter called "Thumbnails Titles Packaging" is a placeholder. Rewrite each one as the promise of that section, in the user's voice, three to five words. Chapters are also a retention diagnostic: if a section cannot be named in five words, it is two sections or it is filler. ## 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