skills/youtube-script/references/storytelling-documentary.md

# YouTube Storytelling / Documentary Scriptwriter

Write an original spoken-word script that tells a true story. Patterns below come from the 20 most-viewed videos each of nine leading channels in the genre (~180 scripts). They describe craft, not personas — never copy any real creator's branded bits, rituals, or catchphrases; invent originals. The category's defining law: **the premise is on screen inside 30 seconds — 180 of 180 top hooks do this** — and the answer to the title's question is withheld to 60–80% of runtime, released as partial reveals.

## Step 1 — Intake

Establish before writing (ask only for what's missing):

1. **The story** — real events, verified facts, sources. Mark anything unverified with ⚠ VERIFY tags; never invent facts for a documentary.
2. **The narrator register** — commit fully to one, no middle ground:
   - **Present companion**: first person, contractions, reactions kept in, seams showing. For investigative essays, challenge videos, personality-led docs.
   - **Composed narrator**: third person, invisible until the verdict, formal-but-plain. For mysteries, procedurals, business epics.
3. **The format lane**: game/challenge · scale ladder (geography/size) · economic argument · cinematic procedural/manhunt · forensic mystery · investigative essay · business epic · comedy retelling.
4. **Target length** (~145 spoken words/min; long-form docs run 30–80 min). If the target is ≤4 minutes, apply **Short-form mode** (below) instead of the long-form beat map.
5. **The withheld thing** — what the audience doesn't get until 70–85%. If the title reveals the outcome, withhold the mechanism.

## Step 2 — Hook (offer 3 options, ≤30 seconds each)

| Hook type | Formula |
|---|---|
| Prize–stakes–preview | "I [built/gathered extreme thing]. Whoever [condition] wins [prize]. And later — [bigger tease]." |
| Date-stamped cold open | "[Exact date, place]. [Person] is [ordinary action, present tense]. [One wrong detail.]" |
| Prophecy bomb | "…what they don't know: [doom/reversal] is coming." (appended to a cold open — the strongest loop in the genre, spans the whole video) |
| Misconception flip | "You think [X]. Actually [anti-X] — and it's [comparison] bigger/worse/stranger than you think." |
| Superlative object | "This is [record-holding thing]. [Stat + comparison ×2]. So how does it [work/fail/escape]?" |
| Investigator's confession | "I've spent [time] obsessed with [question], and everything you've heard about it is [wrong/incomplete]." |
| Archival montage + thesis | Real clips/audio collage first; narrator enters over it with the framing thesis. |
| Contradiction autopsy | "[Accepted explanation]. That's the answer… except it doesn't hold. Here's why." |

Restate the title's promise nearly verbatim inside the first 30 seconds.

## Step 3 — Structure (the mortgage template)

The cold open is a mortgage the middle of the video pays off:

- **0–2%** Hook.
- **2–8%** Frame & contract: why it matters, "let me show you how this happened", source credibility up front for investigative lanes.
- **8–15%** **Rewind to origins** — time jumps backward, chronology begins.
- **25–35%** First plateau — a natural act break: land a partial payoff, then re-hook with an explicit stakes-raising line.
- **35–70%** 3–5 escalation chapters. Each ends destabilized, never complete ("but this was still not the end"). Drip partial reveals: name → method → location. One twist or pattern interrupt per chapter.
- **70–85%** Convergence: **replay the cold-open scene with full context** — the biggest reveal lives here.
- **85–100%** Hedged verdict → zoom out to a universal insight or kicker aphorism. End within seconds of the emotional payoff; no outro essay.

**Lane variants**: game/challenge = rules-as-sportscast, twist per act, counters as spine, end on the winner's reaction. Scale ladder = one question, monotonic physical progression, comparison per step, end on humility. Economic argument = thesis → statistical proof → history → mechanism → counterpoint → kicker (no cold open needed). Business epic = 5–10% "why you should care" essay before the chronology. Comedy retelling = escalating farce, joke every 5–15s, in-character narrator allowed.

## Step 4 — Register & retention rules

- **Tense is a camera**: narrate past events in present tense to put the viewer inside the scene; switch to past tense for analysis. Reserve present tense for scenes, past for investigation.
- Alternate punch sentences (4–8 words) with explainer sentences (20–30 words); never two long ones back-to-back.
- **No naked numbers** — every stat gets a comparison object ("an elephant balancing on a postage stamp"). Every term gets an in-line gloss; every actor gets a role tag on early mentions ("Hoover, the director of the FBI").
- Plant explicit IOUs ("more on that later") in act one; **pay every IOU**; keep at most one loop older than 5 minutes (the cold-open loop).
- Reference only setups the script actually planted: never write "as I promised" or "remember that detail" unless the earlier line exists in this script — a false callback is an instant credibility break.
- Repeat the core question verbatim as a refrain after each partial payoff (~3× per video).
- Make progress legible with a counter the audience can track (players left, dollars, depth, dates).
- Stretch single reveals: syllable-by-syllable reads, "wait — did you catch that?" double-takes.
- **Hedge at the peak**: attach one honest caveat to your biggest claim ("we could not corroborate that") — trust maintenance is a retention device, and its absence marks lower-trust channels.
- Pattern interrupt whenever exposition runs past ~60 seconds: a stunt, a skit, a vox pop, a puzzle.
- Payoff cadence by lane: ladder formats every 10–20s; challenge formats every 20–40s; stat-driven essays every 30–60s; cinematic procedurals a chapter payoff every 2–4 min with tentpole reveals at ~45/65/80%.

## Step 5 — Ending & outro

Do not invent sponsor reads, brand integrations, merch, product plugs, or other monetization beats. Include a specific monetization integration only when the user explicitly requests it, placed at a clean boundary outside a rising sequence. Otherwise the ending is: hedged verdict → universal insight or kicker aphorism → stop within seconds of the emotional payoff. Optionally add ONE plain closing line (a next-video pointer or a subscribe invitation) at the very end — never inside a rising sequence — or end cold on the kicker, which is a valid signature for mystery formats.

## Step 6 — Anti-patterns (hard avoid list)

- No throat-clearing, no "before we start", no channel jingle preamble.
- No early verdicts — opinion is quarantined to the final 10–15% and flagged as opinion.
- No overclaiming: volunteer the weaknesses of your own story.
- No recap padding — reference loops ("remember that advice"), never replay them.
- No neutral chapter transitions — chapters end destabilized.
- No moralizing mid-story: ethical framing is front-loaded once or saved for the coda.
- No invented dialogue or interior monologue presented as fact.

## Short-form mode (target ≤ 4 minutes)

The beat maps above were measured on long-form; under ~4 minutes the physics change. Apply these overrides and keep everything else (register, tense-as-camera, no naked numbers, ethics):

- Budget: ~150 wpm → a 3-minute video is ~420–470 spoken words. Every sentence earns its place.
- **The first line IS the hook** — a date-stamped scene or superlative object in one sentence, no frame/contract section, no source-credibility beat (fold sourcing into one clause if needed).
- **One loop only**: the cold open's withheld detail, opened in sentence one, paid in the final 15%. No IOU stack, no refrains, no chapter structure, no mid-video pivot.
- Structure collapses to: hook (0–10%) → one compressed chronology with a single escalation (10–80%) → the reveal/payback (80–95%) → one-line kicker, hard stop (no zoom-out essay, no verdict section).
- Timestamps every 15–30 seconds; retention map shrinks to 3–5 lines.
- Outro: one plain line max, or hard stop on the kicker.
- If vertical (Shorts): the hook must also work muted (assume on-screen text), and consider a loop-close — the final line hands back into the first line so the video rewatches seamlessly.

## Output format

```
# [Working title] — [lane], ~[N] min

## Hook options (pick one)
[3 hooks, each 40–80 words, labeled by type]

## Script
[Timestamped sections: 【0:00】…]
[Narration as flowing spoken prose; punch sentences on their own lines]
[Cues in brackets: [ARCHIVAL: …] [B-ROLL: …] [MAP: …] [ON-SCREEN COUNTER: 232 remaining]]
[⚠ VERIFY tags on facts the user must confirm]

## Retention map
[One line per IOU / refrain / partial reveal / counter beat / cold-open payback, with timestamp]
```

Claims about the script belong in the script: no self-reported pacing or compliance boasts in titles or headers — the retention map is the only meta-commentary, and it lists devices, not grades.

For full pattern detail (10-hook taxonomy with illustrative examples, all nine sub-style archetypes, payoff cadence tables), read `references/storytelling-documentary-patterns.md`.