video-script — Claude Code skill: scripts and installation
The video-script Claude Code skill drafts short talking-head, explainer, and product-demo videos. It activates for requests to write or revise a script, hook, or YouTube, TikTok, Reels, or LinkedIn video.
MIT ★ 541 updated 2026-11-09
npx skills add dotslashsimran/simcraft --skill video-script -a claude-codeWhat video-script does
The skill turns a creator’s notes or voice transcript into a script built around one question, one story, and one takeaway. It starts with the creator’s own phrasing, then shapes a hook, brief context, the story or demo, and a closing line.
It sizes the script to the requested runtime by counting words and estimating how long the video will take. Each line carries one beat for a single take; B-roll and graphic ideas go in a separate section. A fact-check list names sources for claims, while unconfirmed claims get a warning.
Scripts are intended for videos from 30 seconds to 3 minutes. The creator needs to provide a voice note, transcript, notes, or a rough paragraph; without source material, the skill asks questions one at a time.
What it helps with
- turn voice notes or rough drafts into a video script
- focus a video on one story and takeaway
- fit a script to a target runtime
- flag claims that need source checks
Example prompts for the agent
- Draft a short product launch video from this transcript.
- Cut my draft to a two-minute video and give it a strong opening.
- Revise this Reels script and list the claims that need checking.
How to install video-script
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill video-script -a claude-code2Manually: put the files in place
~/.claude/skills/video-script/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/video-script/
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill video-script -a codex2Manually: put the files in place
.agents/skills/video-script/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill video-script -a cursor2Manually: put the files in place
.cursor/skills/video-script/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dotslashsimran/simcraft skills/planning/video-script2Manually: put the files in place
.github/skills/video-script/SKILL.md1Skills CLI (Vercel)
npx skills add dotslashsimran/simcraft --skill video-script -a gemini-cli2Platform CLI
gemini skills install https://github.com/dotslashsimran/simcraft --path skills/planning/video-scriptManually: put the files in place
.devin/skills/video-script/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about video-script
How do I install video-script in Claude Code?
Run npx skills add dotslashsimran/simcraft --skill video-script -a claude-code. The skill file will be at ~/.claude/skills/video-script/SKILL.md.
What does video-script do?
It shapes a creator’s words into a short video script centered on one question, story, and takeaway. It estimates runtime and lists claims to verify with sources.
What does video-script need to work?
Provide a voice note, transcript, notes, or a rough paragraph from the creator. If there is no source material, the skill asks questions individually to gather it.
Source text
SKILL.md · MIT
---
name: video-script
description: Write a short talking-head, explainer or product demo video script (30 seconds to 3 minutes) that sounds like the creator, not like AI. Starts from their own voice-note ramble, builds one question, one story, one lesson, puts the stakes in the first line, sizes it to the target length, and lists every fact to check with sources. Use when asked to write, draft, plan or fix a video script, a hook, a YouTube/TikTok/Reels/LinkedIn video, an explainer, or "how to X in under 2 minutes" content.
---
# Video script
Most AI scripts fail the same two ways: they sound written instead of said, and they try to cover everything. This skill fixes both. It shapes the creator's own words instead of writing new ones, and it cuts the video down to a single idea.
## 1. Get their words first
Before writing anything, ask for a voice-note ramble: "Tell me about it like you'd tell a friend, for two minutes. Don't plan it." A pasted transcript, notes or a messy paragraph also works.
Their phrasing, their jokes and their pet words go into the script. Keep their contractions, their sentence length and their quirks. A line they'd never say out loud gets cut, however good it reads. If they won't ramble, ask one question at a time until there is enough of their voice to work with.
## 2. One question, one story, one lesson
Pick exactly one of each:
- **The question** the viewer has, in the viewer's words ("Why did the AI give away the data if nobody clicked anything?").
- **The story** that answers it: one real incident, one demo, or one thing that happened to the creator. Real and specific beats general and clever. Names, numbers, dates.
- **The lesson** the viewer leaves with, in one sentence.
Everything else goes in a "next video" list at the bottom. Two good ideas make two videos.
## 3. The shape
| Part | Length | Job |
|---|---|---|
| Hook | 1 to 2 lines, under 5 seconds | The damage or the surprise, in line 1. "This chatbot agreed to sell a brand-new SUV for $1." Never "Hey guys" or "In this video". |
| Setup | 2 to 4 lines | Just enough context to follow the story. |
| Story / demo | most of it | What happened, in order, one beat per line. Show, don't summarise. |
| Turn | 1 to 2 lines | Why it happened. The lesson, said plainly. |
| Close | 1 to 2 lines | What to do about it, or a call to action. Stop as soon as it's said. |
For "how to X" videos the hook is the result ("Here's how to catch this in under 2 minutes") and the story is the steps, cut straight to the action.
## 4. Size it
People speak about **150 words a minute** on camera (130 for careful explainers, 170 for fast social clips). A 2 minute video is about 300 words. Count the words and say the estimated length at the top. If it's long, cut setup first, then whole beats. Don't speed-read it shorter.
## 5. Make it sayable
- One idea per line, so each line is one take.
- Short words, short sentences. Numbers as they're said ("forty-two", "$4,850").
- No stage directions in brackets unless the user asks for them. Put B-roll and graphic ideas in a separate column or list.
- Read it out loud (or ask the user to). Fix every line that trips.
## 6. Facts
Under the script, list every claim that can be wrong (names, numbers, dates, quotes, what a product does), each with the source it came from. Mark anything you couldn't confirm with ⚠. Don't present an unchecked claim as fact. For a story about a real company or person, stick to what public sources say.
## Output
```
Title / caption idea
Length: ~2:05 (312 words)
[script, one line per beat]
B-roll / graphics: ...
Facts to check: ... (with sources)
Next video: ...
```
Give one strong version, not five options. If the user wants alternatives, offer two hooks, not two scripts.
© dotslashsimran · MIT · dotslashsimran/simcraft