--- name: youtube-copy description: Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy". ---

# YouTube Copy

Write the four pieces of YouTube metadata that drive clicks and rank: **title, description, tags, chapters**. Ground everything in the provided source (transcript / topic) — never invent claims the source doesn't support. For chapters you need a **timestamped** source (SRT or `words.json`); without timestamps, ask for them or skip chapters.

## Output format Write `youtube.md` (or print the same structure) exactly like this:

``` # YouTube

**Title**

<title>

**Description**

<description>

**Tags**

#tag1 #tag2 #tag3 ...

**Chapters**

00:00 - <chapter> 01:15 - <chapter> ... ```

(When `/produce-video` calls this skill, write `youtube.md` into the output folder.)

## Writing rule (non-negotiable) **Never use em-dashes (— or –). Use a hyphen `-` instead.** This applies to the title, description, chapter separators, everything.

## Title (the single highest-leverage element) - **60-70 characters** (hard max 100; anything past ~70 truncates on most surfaces). - **Primary keyword near the front** so YouTube and viewers see the topic immediately. - Do all three: **spark curiosity/emotion** (surprise, urgency, FOMO, benefit), **include the keyword**, and **set honest expectations** (a title that oversells tanks watch-time and is clickbait — avoid it). - Use a **number** when natural (numbers attract the eye) and **emotive/power words** ("actually", "finally", "stop", "the right way", "type-safe", "without"). - Use the audience's real **lingo**, not generic phrasing. - Optional: 1-2 relevant hashtags only if they add discovery; usually skip in the title. - Avoid: misleading bait, ALL CAPS spam, profanity, >70 chars. - Useful formula starters (pick what fits, don't force): "How to X (without Y)", "The X that Y", "Stop doing X - do this instead", "X explained in N minutes", "I tried X so you don't have to", "N ways to X".

## Description Structure, front-loaded (the first ~100-160 chars show above the fold / in search): 1. **Hook (first 1-2 sentences)** containing the **primary keyword** — answer "what is this and why watch it?". Promise the outcome. 2. A short paragraph (2-4 sentences) expanding what the viewer learns. 3. **Chapters/timestamps** (see below) for videos > ~10 min (or whenever there are clear sections). 4. Optional links/CTA (main link, "watch next", subscribe) - only if the user provided them; don't fabricate URLs. 5. **2-3 relevant hashtags** at the very end. - Length: tight and useful, roughly **150-300 words / under ~1000 characters**. Write for humans; weave related keywords naturally, never keyword-stuff.

## Tags - **5-15** tags, comma/space free per tag (no spaces inside a multi-word tag is not required, but keep them clean). - **Primary keyword/phrase first**, then a mix of **broad** (e.g. `react`, `webdev`) and **specific** (e.g. `react router loader data`, `unstable_useRouteLoaderData`). - Quality over quantity; all tags must genuinely describe the content. No unrelated/spam tags, no competitor names. - Output them prefixed with `#` in `youtube.md` for readability (they're entered without `#` in YouTube's tag box).

## Chapters (need a timestamped source) YouTube's hard rules: **first chapter must be `00:00`**, **at least 3 chapters in ascending order**, each chapter **>= 10 seconds** long. - **First chapter (`00:00`)** answers *"why did they click?"* - name it the payoff/topic (e.g. "Type-safe loader data", "The final result"), NOT "Intro". - Titles: **3-8 words**, one clear noun phrase (mobile crops long ones). Replace useless labels ("Intro", "Demo", "Conclusion", "Q&A") with the actual topic of that section. - Frequency: roughly every **2-4 minutes** for tutorials, **5-10 minutes** for long-form; aim for **5-15 chapters** total, never > ~20. - Derive each `MM:SS` start from the timestamped source (the moment that section actually begins). Use `MM:SS` (or `H:MM:SS` past an hour). Separator is `-` (a hyphen), never an em-dash.

## Process 1. Read the source. If it's an SRT/`words.json`, use the timestamps for chapters; if it's plain text or a topic, write title/description/tags and note that chapters need a timestamped source. 2. Identify the **primary keyword/topic** (what someone would search) and the **payoff** (why they'd click). 3. Draft 2-3 title options, pick the strongest against the rules above, then write description, tags, chapters. 4. Self-check: title <= 70 chars and keyword-forward; description hook has the keyword in the first sentence; tags 5-15 and relevant; chapters start at 00:00, ascending, >=3, descriptive; **no em-dashes anywhere**.

## References - [vidIQ - YouTube titles (11 formulas)](https://vidiq.com/blog/post/youtube-video-title/) - [vidIQ - YouTube descriptions](https://vidiq.com/blog/post/youtube-video-descriptions/) - [YouTube Help - Video chapters](https://support.google.com/youtube/answer/9884579)