Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dotslashsimran/simcraft --skill video-script -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/video-script/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/video-script/

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

Similar skills

All skills for Marketing and content →

From the same set24

The whole set →
teach-back The teach-back Claude Code skill checks understanding by asking for an explanation in the learner’s own words. It probes gaps one question at a time, then creates a cheat sheet and review questions. CX Codex +1 ★ 541repo stars brand-kit This Claude Code skill captures a company's visual identity from its website and saves a reusable brand kit. It runs before creating branded videos, stickers, or graphics. CX Codex +1 ★ 541repo stars next-step The next-step Claude Code skill turns a large goal or an unstructured task dump into one next action. It activates for planning requests or when someone is unsure how to begin. CX Codex +1 ★ 541repo stars from-scratch The from-scratch Claude Code skill teaches how a technology works by building a small version step by step. Before each run, the agent asks for a prediction, then checks it against the program’s output. CX Codex +1 ★ 541repo stars repo-timelapse The repo-timelapse Claude Code skill turns a repository’s Git history into a video of the project changing over time. It runs on requests to show project growth or animate commits. CX Codex +1 ★ 541repo stars skill-router The skill-router Claude Code skill selects a matching skill or builds a sequence for a task. It kicks in when a request is vague or could call for several skills. CX Codex +1 ★ 541repo stars bisect-anything The bisect-anything Claude Code skill tracks a regression to a commit, dependency version, or config value. It activates for requests to find what broke a test or when a problem began. CX Codex +1 ★ 541repo stars scripted-screencast The scripted-screencast Claude Code skill turns scripted browser actions into a product demo video with cursor effects, zooms, and captions. It activates for screencast requests and rerenders after interface changes. CX Codex +1 ★ 541repo stars

Project sponsors

Companies that keep this analytics open