---
name: owainlewis/youtube-description-writer
source: https://app.decimal.ai/s/owainlewis-youtube-description-writer@2/SKILL.md
source_sha256: 757a693d1fea
---

# 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

```markdown
{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

```markdown
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