# vsl-storyboard-writer

Turns a video brief into a scene-by-scene storyboard for sales videos, product demos and social ads.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 464 installs · ★ 52
- Author: ncklrs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ncklrs/startup-os-skills/tree/HEAD/skills/vsl-storyboard-writer/SKILL.md
- Updated: 2026-02-26
- HTML: https://affpapa.org/en/nevibecode/skills/vsl-storyboard-writer

## What it does

The skill writes the script and the storyboard together. Every scene comes with on-screen copy, a visual description, timing, the emotion the viewer should feel, and notes for the animator. The output is shaped for handoff to a motion designer and for Remotion production.

Inside are frameworks picked by video length and goal: a short hook-to-CTA pattern for social ads, PAS for cold traffic, AIDA for product demos, the classic VSL structure for longer sales pages, and an explainer format. There is also a breakdown of hook types for the opening seconds and duration guidance from micro-content up to multi-minute videos. Tell it the length and the objective and it picks the framework.

Handy when a script is needed now rather than after a round of approvals. It stays on structure and copy though — no editing, no rendered video, just a script you pass downstream. Without a motion designer or a Remotion pipeline, some of those animator notes will go unused.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/vsl-storyboard-writer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/vsl-storyboard-writer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/vsl-storyboard-writer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/vsl-storyboard-writer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ncklrs/startup-os-skills vsl-storyboard-writer
```

2. **Manually: put the files in place**
- File: `.github/skills/vsl-storyboard-writer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ncklrs/startup-os-skills --path skills/vsl-storyboard-writer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vsl-storyboard-writer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ncklrs/startup-os-skills/tree/HEAD/skills/vsl-storyboard-writer/SKILL.md

## When to use it
- write a sales video script for a fixed duration
- build a product demo storyboard with per-scene timing
- come up with a hook for the opening seconds
- map the offer and objection handling onto scenes
- hand a script to a motion designer in a ready format

## Example prompts
- write a 90-second VSL script for our product demo
- storyboard a 30-second social ad using the PAS framework
- script an explainer video about our service for a marketing audience

## Similar
- [scriptwriting](https://affpapa.org/en/nevibecode/skills/scriptwriting.md) — skill · 322 installs
- [storyboard-creation](https://affpapa.org/en/nevibecode/skills/storyboard-creation.md) — skill · 55500 installs
- [explainer-video](https://affpapa.org/en/nevibecode/skills/explainer-video.md) — skill · 1500 installs
- [marketing-pipeline-share-ai-content-automation](https://affpapa.org/en/nevibecode/skills/marketing-pipeline-share-ai-content-automation.md) — skill · 766 installs
- [marketing-pipeline-share-ai-content](https://affpapa.org/en/nevibecode/skills/marketing-pipeline-share-ai-content.md) — skill · 761 installs
- [muapi-storyboard](https://affpapa.org/en/nevibecode/skills/muapi-storyboard.md) — skill · 686 installs

From the same set: [ncklrs/startup-os-skills](https://affpapa.org/en/nevibecode/by/ncklrs/startup-os-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md