Video script writer
@contentstudio/video-script-writer
Write video scripts that are easy to film: short vertical videos (15 to 90 seconds) and longer explainers or demos (3 to 10 minutes), in a two-column format with what is said, what is on screen, timing from word count, and a shot list.
- Activity
- New: be the first to try it
- Installs
- 0 installs
- Likes
- 0 likes
- Clones
- 0 clones
How this works
- It is a skill: written instructions Claude reads when your request matches what the skill is for. You do not call it by name; just ask for the task.
- While it works, it reads and changes files in the places it lists, nowhere else.
- Nothing runs until you choose to use it, and you can remove it any time.
SKILL.md
Video script writer
A script for video is not an article read aloud. It has to hook in seconds, be sayable in one breath per line, and tell the person holding the camera what to shoot. This kit writes scripts in the two-column format editors use, timed from the word count.
When to use
- Short vertical video for Reels, TikTok, Shorts, or LinkedIn.
- Product demos, explainers, onboarding videos, YouTube videos, webinar intros.
- "Script this", "what do I say in a 60-second video about X?", "turn this blog into a video".
Inputs
- Topic and the one takeaway the viewer should leave with.
- Length and platform. Default: 60 seconds vertical. Pacing assumption: about 150 spoken words per minute (130 for a demo with clicks, 170 for a fast talking-head).
- Who is on camera (founder, presenter, voiceover only, screen recording only) and what can be filmed (a phone, a screen recorder, b-roll of the office).
- Source material: a post, doc, or demo flow in
content/. - Call to action: follow, visit a link, book a demo, comment.
- Voice:
brand.mdif it exists.
Steps
- Write three hooks for the first 3 seconds (short) or 15 seconds (long). Types: a surprising result, a direct question, a "you are doing X wrong", or showing the end result first. Pick one and say why.
Outline the beats:
- Short: hook (0 to 3s), problem (3 to 10s), 2 or 3 points or steps, payoff, call to action (last 5s).
- Long: hook and promise (0 to 30s), context (why it matters), 3 to 5 sections each with one idea and a visual, recap, call to action. Put a re-hook ("here is where it gets interesting") at about one third.
- Write the script in two columns. Spoken lines short enough to say in one breath (under 15 words). Plain words. Contractions. No lines that only work when read.
- Time it. Count words per section, convert at the pacing above, and show seconds per row and a total. If over length, cut the weakest point, not the hook or the call to action.
- Add on-screen text for the key line of each section (most short video is watched muted) and caption notes.
- Add a shot list grouped by location or setup, so filming happens in one pass.
- Save to
content/video/<slug>.mdand show the script.
Output format
# Video: <title> (60s vertical, talking head)
Takeaway: <one line> | Words: 148 | Est. 59s at 150 wpm
Hook options
1. "Your reminder texts are too long." (chosen: direct and testable)
2. ...
| Time | Spoken | On screen | Shot |
| --- | --- | --- | --- |
| 0:00 to 0:03 | "Your reminder texts are too long." | TEXT: "Too long." | Close-up, phone in hand |
| 0:03 to 0:10 | "We tested short versus long across thousands of reminders." | Two phones side by side | Screen recording |
Call to action: <line>
## Shot list
- Desk setup: talking head, rows 1, 4, 6
- Screen recording: rows 2, 3
## Caption notes
- Burn in captions; key words in bold: "too long", "2 lines".Guardrails
- Never invent results, customer names, or testimonials. Use
<need: real number>placeholders. - Do not script claims a regulated industry cannot make (health outcomes, financial returns) without flagging them for review.
- Keep on-screen text to 6 words or fewer per card.
- If a demo shows a product, script only features the user confirms exist.
README.md
Video script writer
Get a video script you can actually film: what to say, what is on screen, how long each part takes, and a shot list so you film it in one go. Works for 60-second Reels and Shorts and for 5-minute demos and explainers.
Who it is for: founders and marketers who need to be on camera, or need a demo video, and freeze up without a script.
Example
Input: "60-second vertical video for LinkedIn. Takeaway: short reminder texts get more replies. I'm on camera, plus a screen recording."
Output (content/video/short-reminders.md, excerpt):
| Time | Spoken | On screen | Shot |
|---|---|---|---|
| 0:00 to 0:03 | "Your reminder texts are too long." | TEXT: "Too long." | Close-up |
| 0:03 to 0:10 | "Here is what happened when we cut ours to two lines." | Two phones side by side | Screen recording |
| 0:50 to 0:59 | "Try it this week. Tell me what your reply rate does." | TEXT: "Try 2 lines" | Close-up |
Words: 148, about 59 seconds at 150 words per minute. Plus three hook options, a shot list grouped by setup, and caption notes.
What it can access
- Reads your drafts in
content/andbrand.mdfor voice. - Writes only inside
content/video/. - No scripts, no network.
Setup
None. Works in Claude Code, Codex, and Cursor.
Files
- README.md
- SKILL.md
- kit.json
Did it work?
0worked for them0did not work
Sign in to say whether it worked for you.
Nobody has said yet. Tried it? Tell the next person.
