| name | youtube-scriptwriting |
| description | Write retention-optimized long-form YouTube scripts through a checkpoint workflow (research, hook, structure, body, editing). Use when asked to "write a YouTube script", "YouTube video outline", "long-form video script", "improve video retention", "structure a YouTube video", or when turning raw ideas/transcripts/notes into a compelling video script. Covers hook formats, 7 story structures, rehook techniques, editing audits, and outro binge loops. |
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:
- Target audience: Who specifically is watching? What do they already know?
- Desired emotion: Pick ONE primary emotion to transfer:
- Awe/inspiration
- Amusement/humor
- Excitement/joy
- Anger/outrage
- Surprise/shock/curiosity
- Sadness/empathy
- 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.
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 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):
- Alignment: Visual, spoken, and text hooks match
- Speed: Value promised in first 3 seconds
- Clarity: Topic is unmistakable
- Curiosity: Opens a question they must answer
Checkpoint 4: Choose Story Structure & Outline
Pick ONE structure. See 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:
- Context: What is it? (Simple, clear)
- Application: How to use it? (Examples)
- 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.
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):
- Link back to video content naturally
- Introduce a NEW problem/question
- 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
