yt-chapters

1# yt-chapters
2 
3```bash
4python3 chapters.py transcript.srt --target 8
5```
6 
7## The rules, which are not optional
8 
9A chapter list that breaks any of these silently does not become chapters at all - the block just
10sits in the description doing nothing:
11 
12- The first entry must be **00:00**.
13- There must be **at least three**.
14- Each must be **at least 10 seconds** long.
15 
16The tool checks all three and tells you when a list is invalid rather than letting you paste it.
17 
18## Retitle every line
19 
20`chapters.py` finds the BOUNDARIES well - it scores the pauses you actually took by how much the
21vocabulary shifts across them. The titles it emits are the topic words, and they are a draft. A
22chapter called "Thumbnails Titles Packaging" is a placeholder. Rewrite each one as the promise of
23that section, in the user's voice, three to five words.
24 
25Chapters are also a retention diagnostic: if a section cannot be named in five words, it is two
26sections or it is filler.
27 
28## The gate
29 
30Nothing here publishes. This skill writes and you publish. Every output ends in a block the user
31copies, and the last line of every run is the question: **ship it, or change it?**