scriptwriting — Claude Code skill: what it does, how to install
Structured skill for drafting video scripts, storyboards, and messaging. Guides pacing from the first hook to the final call to action.
npx skills add gtmagents/gtm-agents --skill scriptwriting -a claude-codeWhat scriptwriting does
The skill builds video scripts around a five-step structure: an opening hook in the first 5 seconds, the problem or insight, the solution story, proof points, and a single call to action. It targets explainer videos, customer testimonials, and product walkthroughs.
Output formats include a two-column script layout with voiceover, visuals, motion notes, and timing. It also provides a storyboard grid and a voice checklist. Visual cues cover B-roll, overlays, text callouts, and motion direction.
Short cutdowns like a 15s teaser or a 6s bumper are planned from the start. You still need to supply your brand positioning and compliance guidelines upfront, because the skill builds directly on those inputs.
What it helps with
- structure scripts for product walk-throughs and explainer videos
- format storyboards with visual direction, audio notes, and text overlays
- hook viewer attention in the first 5 seconds
- plan cutdowns for 15s teasers and 6s bumpers
Example prompts for the agent
- Draft a product explainer script using the scriptwriting framework
- Create a storyboard grid with visuals, voiceover, and notes for an interview
- Generate a script along with cutdown plans for a 15s teaser and a 6s bumper
How to install scriptwriting
1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill scriptwriting -a claude-code2Manually: put the files in place
~/.claude/skills/scriptwriting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/scriptwriting/
1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill scriptwriting -a codex2Manually: put the files in place
.agents/skills/scriptwriting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill scriptwriting -a cursor2Manually: put the files in place
.cursor/skills/scriptwriting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gtmagents/gtm-agents scriptwriting2Manually: put the files in place
.github/skills/scriptwriting/SKILL.md1Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill scriptwriting -a gemini-cli2Platform CLI
gemini skills install https://github.com/gtmagents/gtm-agents --path plugins/video-marketing/skills/scriptwritingManually: put the files in place
.devin/skills/scriptwriting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gtmagents/gtm-agents --skill scriptwriting -a opencodeClaude.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 scriptwriting
How to install scriptwriting in Claude Code?
Run npx skills add gtmagents/gtm-agents --skill scriptwriting -a claude-code.
What framework does the scriptwriting skill follow?
It organizes scripts into five stages: hook, problem insight, solution story, proof, and a single call to action.
What templates does the skill provide?
It provides a script table for audio and visuals, a storyboard grid, and a tone checklist for brand compliance.
Source text
SKILL.md · Apache-2.0
--- name: scriptwriting description: Use when crafting scripts, storyboards, and messaging for video content. --- # Video Scriptwriting Systems Skill ## When to Use - Developing scripts for explainer, testimonial, thought leadership, or product videos. - Aligning scripts with positioning, CTA, and voice/tone guidelines. - Iterating on scripts based on feedback or performance data. ## Framework 1. **Hook** – capture attention in first 5 seconds (question, stat, bold claim). 2. **Problem/Insight** – relate to audience pain or opportunity. 3. **Solution Story** – product capability or narrative proof with visuals. 4. **Proof** – customer quote, metric, analyst validation. 5. **CTA** – single next step (demo, trial, download, subscribe). ## Templates - Script template with columns for VO/dialogue, visuals, motion notes, duration. - Storyboard grid with frame, description, audio, graphics, CTA. - Tone/voice checklist (personality traits, jargon allowances, compliance notes). ## Tips - Write for ear: short sentences, contractions, conversational tone. - Add direction for B-roll, overlays, animations, and text callouts. - Plan variant clips (15s teaser, 6s bumper, square stories) from the start. ---
© gtmagents · Apache-2.0 · gtmagents/gtm-agents
