youtube-scriptwriting

# YouTube Script Writing

Transform disorganized ideas into retention-optimized scripts through a checkpoint-based workflow.

## Core Psychology

All great scripts operate on one principle: **Reality must beat expectations.**

- Viewer expectations = what they think will happen based on title/thumbnail
- Reality = what you actually deliver in the video
- When reality > expectations → satisfaction, engagement, shares
- When reality < expectations → disappointment, drop-off, bounce

## The Workflow

### Checkpoint 1: Define the Foundation

Before writing anything:

1. **Target audience**: Who specifically is watching? What do they already know?
2. **Desired emotion**: Pick ONE primary emotion to transfer:
   - Awe/inspiration
   - Amusement/humor
   - Excitement/joy
   - Anger/outrage
   - Surprise/shock/curiosity
   - Sadness/empathy
3. **Core promise**: One sentence describing what viewer gets from watching

### Checkpoint 2: Research & Mine for Shock

Find the facts that will beat expectations. See [references/research.md](references/research.md).

**Shock Score Method**: Rate each fact 1-100 based on "How many viewers would NOT know this?"
- 80+ = Gold (most viewers surprised)
- 50-79 = Good supporting points
- Below 50 = Skip unless essential context

Collect 5-10 high-shock facts before proceeding.

### Checkpoint 3: Write the Hook

The hook confirms the click and opens a curiosity loop. See [references/hooks.md](references/hooks.md) for the 9 proven formats.

**Quick Formula**: Target + Transformation + Stakes
- **Target**: Who is this for?
- **Transformation**: What will they gain?
- **Stakes**: What happens if they don't watch?

**Hook Commandments** (verify all 4):
1. Alignment: Visual, spoken, and text hooks match
2. Speed: Value promised in first 3 seconds
3. Clarity: Topic is unmistakable
4. Curiosity: Opens a question they must answer

### Checkpoint 4: Choose Story Structure & Outline

Pick ONE structure. See [references/structures.md](references/structures.md) for all 7.

**Most Common:**
- **Breakdown**: Complex concept in building blocks
- **Case Study**: How X achieved Y (framework pieces)
- **Listicle**: Ordered independent items
- **Problem-Solver**: Agitate pain → deliver solution
- **Tutorial**: Step-by-step (contingent steps)
- **Personal Story**: First-person narrative with lessons
- **Newscaster**: Factual recounting (journalist style)

Use "But-Therefore" transitions, not "And-Then":
- "I did this. **But** then this happened. **Therefore** I had to do this."

### Checkpoint 5: Write the Body

For each section, use the **Value Loop**:
1. **Context**: What is it? (Simple, clear)
2. **Application**: How to use it? (Examples)
3. **Framing**: Why does it matter? (Connect to bigger picture)

**Retention rules:**
- **Rehooks** every 30-60s: reagitate the promise ("But here's where it gets interesting...")
- **Second-best first**: Put 2nd-best point first, best point second (ascending pattern keeps viewers)
- **Setups & Payoffs**: Tease information, delay reveal, then deliver

### Checkpoint 6: Edit for Quality

Run three audits. See [references/editing.md](references/editing.md).

**1. Story Flow Audit**
- Is every line necessary to the through-line?
- Delete tangents. Save them for another video.

**2. Comprehension Audit**
- 6th grade vocabulary
- Short sentences (staccato)
- Active voice
- Restate complex ideas twice (second time simpler)
- Name your frameworks (labels aid recall)

**3. Speed-to-Value Audit**
- Value signaled in first 3 seconds?
- Rehooks every 30-60 seconds?
- Each section has its own mini-payoff?

### Checkpoint 7: Outro & CTA

**Binge Loop Formula** (last 15-30 seconds):
1. Link back to video content naturally
2. Introduce a NEW problem/question
3. Promise to solve it in another video

## Script Template

```
HOOK (0-15 seconds)
- Confirm the click
- Open curiosity loop
- Establish credibility (optional)

BODY SECTION 1 (Rehook → Content → Payoff)
[Second-best point]

BODY SECTION 2 (Rehook → Content → Payoff)
[Best point]

BODY SECTION 3+ (Rehook → Content → Payoff)
[Remaining points in descending order]

OUTRO (Last 15-30 seconds)
- Summarize value delivered
- Binge loop to next video/resource
```

## Output Format

Produce a markdown script with:
- Header: title, target audience, desired emotion, core promise, estimated duration
- Each section: heading, rehook line, body content, payoff
- Inline notes: [REHOOK], [SETUP], [PAYOFF], [CUT HERE] markers for the editor
- Estimated timestamps for each section

## Key Data Points

From retention research (load `references/retention-data.md` for full data):
- 55% of viewers lost in first 60 seconds
- 20% lost in first 10 seconds
- Pattern interrupt in first 5s = 23% higher retention
- Suspension bridge pattern (open loops) = 68% higher completion
- Strategic breaks at drop-off points = 15-22% re-engagement
- Videos outperforming channel average retention by 15%+ get 2.3x more algorithmic promotion
- Only 16% of viewers reach the final 10% of a video (never save only CTA for end)
- AVD below 40% = deprioritized by algorithm

**Pattern interrupt frequency:**
- Pre-recorded: every 30 seconds
- Live: every 2-3 minutes
- Shorts: every 2-3 seconds

**Energy patterns:**
- Calm-Burst Oscillation (educational): 15-25s calm, then burst every 2-3 min
- Anchor Pattern (essays): return to core thesis every 2-3 min
- Progressive Energy (vlogs): high first 3 min, stabilize, mix after min 8

## References

- [Research & Idea Development](references/research.md)
- [Hook Formats (9 proven)](references/hooks.md)
- [Story Structures (7 formats)](references/structures.md)
- [Retention Techniques](references/retention.md)
- [Editing & Quality Audits](references/editing.md)
- [Retention Data & Benchmarks](references/retention-data.md) — hard numbers on viewer loss, pattern interrupts, CTA placement, MrBeast principles
- [YouTube Algorithm Guide (2025)](references/algorithm-guide.md) — CTR benchmarks by traffic source, AVD thresholds, signal hierarchy
- [Hook Variants (5 types with templates)](references/hook-variants.md) — shock/contradiction, problem-agitation, story-open, curiosity-gap, social proof with decision guide
- [Full Script Template with Annotations](references/script-template.md) — production-ready template with retention risk mapping and pattern interrupt log