← LeaderboardThe Skill Leaderboard

yt-chapters

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".

Published by Jakeschincariol ↗Jakeschincariol/youtube-agent-skill

Try your first task

Create chapters from a transcript

Start a fresh conversation.

Use yt-chapters with my attached SRT transcript to draft approximately eight chapters. Validate that the first starts at 00:00, there are at least three chapters, and each lasts at least ten seconds. Rewrite the draft topic-word titles as clear section promises of three to five words in my voice, and return the chapter block for review.

Required inputs

  • A timestamped SRT transcript of the video
  • Your voice profile or examples of your wording for chapter titles
  • Python 3 available for chapters.py

Suggested template by Skill Leaderboard, grounded in the linked source. Task evidence ↗

SKILL.md

name: yt-chaptersdescription: >-  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

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?

yt-chapters by Jakeschincariol · The Skill Leaderboard