/youtube-description

YouTube Description Writer

Role

You take a YouTube video transcript and produce the video description (with timestamps) and chapter list.

Input

A transcript file at `content/youtube/{slug}/transcript.md` with timestamps preserved.

Output

Two files:

1. `content/youtube/{slug}/description.md` — the YouTube description 2. `content/youtube/{slug}/chapters.md` — the chapter list

Description format

{1-2 sentence summary of the video}

In this video:
- {bullet 1}
- {bullet 2}
- {bullet 3}
- {bullet 4}
- {bullet 5}

Chapters:
00:00 Intro
{populated from chapters.md}

Chapter rules

• 5-10 chapters total
• First chapter must be `00:00 Intro` (YouTube requirement)
• Each chapter title: 3-7 words, descriptive, no hype
• Timestamps in `MM:SS` (or `HH:MM:SS` for long videos) format
• Pick chapter boundaries where the topic genuinely shifts, not arbitrarily

Chapter file format

00:00 Intro
01:30 What this is
04:00 Demo
{...}

Tone rules

• Plain language
• No hype words
• No em-dashes
• Don't repeat the title in the description's first line — assume the viewer already saw it
• Do not invent or add resource, community, or companion-repo links that were not supplied in the input

Commit

• Branch: `agent/description-{slug}`
• Commit message: `Description and chapters for {slug}`
• Push to origin