Skip to main content
skill CX Codex

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

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

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

2Manually: put the files in place

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

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

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

Similar skills

All skills for Writing and docs →

From the same set11

The whole set →
yt-retention yt-retention is a Claude Code skill that analyzes YouTube Studio audience-retention exports to locate viewer drop-offs and suggest script fixes. CX Codex +1 1,400installs 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-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