Video Script
Scripts that sound like the creator on their best day: short, concrete, with a hook that earns the next 30 seconds. Everything comes from their real week and their own words. Nothing is invented.
Before writing
Read, in this order:
video-agent/voice.md: who they are, who they talk to, how they sound, what they believe, their proof, the ask. Missing: offer/video-setup(about 10 minutes, recommended), or ask 4 questions now (what they do, for whom, the language they record in, what viewers should do after watching).video-agent/swipe.mdif it exists: hooks that worked in their niche (from/video-viral).video-agent/audit.mdif it exists: what works on their own account (from/video-audit). Its "3 changes for next week" apply to this week's scripts, and its best topics, lengths and hook formulas come first. Their own data beats the niche's.- The last 20 lines of
video-agent/log.md: topics and hook formulas already used. Never repeat a topic from the last 4 weeks unless they ask. - references/hooks.md, references/script-rules.md and references/humanize.md.
Talk to them in their language, and write the scripts in the language they record in.
Modes
/video-script→ a week of scripts (default 5)./video-script <topic or idea>→ one script./video-script hook <script or topic>→ 10 hooks, scored, best 3 on top./video-script rewrite <script>→ their script, tightened: same content and facts, better hook, shorter lines, timing checked, humanized. Show what changed./video-script humanize <file, script slug or pasted text>→ any text (script, caption, description, post) made to sound like them: references/humanize.md, with its before and after score.humanize checkonly reports.
For hook and humanize, skip "The week" and "The mix": read voice.md and the references, then do only that job.
1. The week
Ask one question: "What actually happened this week?" Give prompts so it's easy: a result (with the number), a mistake, a question a client or a follower asked, something they learned or tested, a tool they used, an opinion that came up in a conversation, something they disagree with.
Real material beats ideas. If they have nothing, propose 5 topics from voice.md (beliefs, mistakes their viewer makes, proof), audit.md (their topics that over-perform) and swipe.md, and let them pick.
Then: how many videos (default 5) and is there something to promote this week (yes → one Offer video, no → none).
2. The mix
Each video gets a type. Plan the week before writing:
| Type | What it does | Default per week of 5 |
|---|---|---|
| Teach | one problem, one fix the viewer can apply today | 2 |
| Proof | a real result and what made it happen | 1 |
| Story | a moment, a turn, a lesson | 1 |
| Opinion | a position against the usual advice in the niche | 1 |
| Offer | the problem, what they made for it, who it's for, the ask | 0 or 1, never 2 |
Show the plan as a table (number, type, topic, hook formula you'll try first) and let them swap before you write. Never the same hook formula twice in a row, never the same type three times in a week.
3. Write each script
- 3 hooks, each from a different formula of hooks.md. Score each with the rubric in script-rules.md. Keep the best; the other two go under "Other hooks". All below 7/10: write 3 more.
- The on-screen hook: 6 words or fewer, shown during the first seconds. It adds to the spoken hook, never repeats it word for word.
- The body, from the structure of its type (script-rules.md). One sentence per line. A re-hook near the middle.
- The end: the ask from voice.md, said once, or a last line that loops into the first.
- Visual notes, apart from the spoken lines: what to show, and the 1 to 4 words worth a callout (a number, a result, a tool name).
- Timing: count the words, divide by their pace (voice.md, else 160 wpm). Check every beat rule in script-rules.md. Fix before showing.
- Facts: every number, name and result comes from voice.md or what they told you. Anything else becomes
{{your number}},{{client name}}, and is listed under "To fill". - Humanize: run references/humanize.md on the script (steps 1 to 6, no report per script). Read it as if spoken aloud. Nothing they would never say (voice.md "Words I never use"), no em dash, no AI shape, every fact intact. Its score goes in the script's Score line.
4. Format
Save to video-agent/scripts/week-YYYY-MM-DD.md (the Monday of the week). One file per week; a single script goes into the current week's file.
# Week of 2026-10-05
| # | Slug | Type | Formula | Length |
|---|---|---|---|---|
| 1 | hooks-too-long | Teach | The mistake | 40 s |
## 1. hooks-too-long
**On screen:** Your hook is *too long*
**Hook:** Your first sentence has 20 words. Nobody hears word 12.
```script
Your first sentence has 20 words. Nobody hears word 12.
By then, most people already swiped.
I checked my last {{number}} shorts.
The ones that held past 3 seconds had short hooks.
Under 12 words, with the topic in the first 5.
Here's the part everyone skips.
Cutting is easy, picking the one point is the hard part.
So write your hook, then cross out everything before the point.
"In this video I'll show you how to write better hooks."
Becomes: "Your hook is too long."
Same idea, half the words, and it lands before they swipe.
Try it on your next three videos.
Follow for one script fix a day.
```
**Visual notes**
- line 1 → callout: 20
- line 5 → callout: 12 words
- line 9 → show: the long hook, crossed out
**Ask:** Follow for one script fix a day.
**Other hooks**
- (Stop / start) Stop explaining in your hook. Start with the result.
- (Their words) "My hook is fine, it's the algorithm."
**Score:** hook 8/10 · human 10/10 · 111 words · 40 s at 165 wpm
**To fill:** {{number}}
The script block holds only the spoken lines: the creator reads it while recording, and video-edit reads it to edit.
Then show a READY summary and wait:
READY · week of 2026-10-05 · 5 scripts (Teach, Proof, Story, Opinion, Teach) · 38 to 52 s
Saved: video-agent/scripts/week-2026-10-05.md
To fill: 3 placeholders
Reply yes to log them, or tell me what to change.
After a yes, add one line per script to video-agent/log.md:
2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers
5. Hand off
Show the week's table and the first script in full, then ask what to change. Next steps: record each script (phone, camera or webcam, one take per script, into video-agent/takes/<slug>.mp4), then /video-edit <slug>, then /video-publish <slug>.
Honest limits
- A strong script is not a promise of views. Topic, timing, delivery and luck matter as much.
- The hook score is a writing checklist, not a prediction.
- Scripts only sound like the creator when voice.md has their real words. A thin voice file gives generic scripts: update it.