| name | youtube-script-writer |
| description | Write a tight, retention-focused YouTube script from a topic, outline, or research brief. Use when the user asks for a video script, wants to turn notes or research into a YouTube video, needs a hook/intro rewritten, or wants to plan a video end-to-end with pacing, visual beats, and CTAs. |
YouTube Script Writer
Turn a topic, outline, or research dump into a YouTube script that holds attention from second 0 through the CTA.
When to use
- "Write a YouTube script about X"
- "Turn this research into a video"
- "Draft an intro / hook for a video on Y"
- "Plan out a 5-minute video about Z"
When NOT to use
- Long-form blog posts or articles (different pacing rules — don't force them into this template)
- Podcast outlines (conversational, not scripted)
- Shorts under 60s (different structure — lead with the payoff, no setup)
Inputs to gather first
Before writing, confirm (ask if missing):
- Topic / angle — what is the one idea the viewer walks away with?
- Target length — under 3 min, 3–8 min, or 10+ min? Pacing changes.
- Audience — beginners, experts, or mixed? Sets vocabulary floor.
- Research or source material — any facts, stats, quotes, URLs to include?
- Tone — casual/educational, docu-style, chaotic/entertainment?
If the user didn't supply research and the topic needs facts, use WebSearch / WebFetch BEFORE writing. Never invent stats or quotes.
Script structure (standard 5–8 min video)
Write the script in these labeled sections. Don't skip any.
1. Hook — first 5 seconds
- One sentence that promises a payoff or opens a loop.
- No "hey guys welcome back." No throat-clearing.
- Patterns that work:
- Curiosity gap — "Everyone gets X wrong. Here's what actually works."
- Bold claim — "You can do X in 10 minutes. I'll prove it."
- Pattern interrupt — visual or verbal surprise.
- End with an implicit "keep watching to find out."
2. Setup — seconds 5–20
- Context: why does this matter NOW, for THIS viewer?
- Credibility beat (one sentence max): who you are / why listen.
- Restate the promise in sharper form. No long preamble.
3. Body — main content
- Break into 2–4 clearly-labeled sections/chapters.
- Retention rule: every 30–45 seconds, re-hook. Tease what's coming ("but here's the twist…"), change visual pattern, or drop a memorable line.
- One idea per section. Don't stack.
- Concrete > abstract. Examples, numbers, screenshots, demos.
- If you have research: cite specifically (brand, study, date). No vague "studies show."
4. Payoff — deliver on the hook
- Close the loop opened in the hook.
- Summarize the one takeaway in one sentence. Viewer should be able to repeat it.
5. CTA — final 15 seconds
- ONE ask. Not three. Pick: subscribe, comment prompt, link in description, or watch-next video.
- Make it natural, tied to the content. "If this saved you X, subscribe" beats "smash that like button."
- End on a strong visual beat, not a fade.
Format the output
Deliver the script as:
TITLE: <working title, clickable but honest>
THUMBNAIL IDEA: <1 sentence, what's on screen>
---
[0:00] HOOK
<exact words to say>
[0:05] SETUP
<exact words>
[0:20] SECTION 1 — <name>
<exact words>
[VISUAL: brief note on B-roll / cut / graphic]
[...continue...]
[X:XX] CTA
<exact words>
Rules for the script body:
- Write the spoken words, not stage directions, as the main text.
- Put visual/cut notes in
[VISUAL: …] tags inline, indented under the spoken line they belong to.
- Use short sentences. Read it aloud in your head — if a sentence is hard to say, rewrite it.
- Contractions always (don't → that's how people talk).
- No jargon without a one-line definition.
After the script
Close with:
- Estimated runtime — rough estimate based on ~150 wpm spoken pace.
- Open questions — anything you had to guess at (e.g. target audience assumed to be X; pick a different tone if wrong).
- Variants to consider — one alt hook and one alt CTA, one line each. Gives the user pivot options.
Retention checklist (self-review before delivering)
