npx skills add ...
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer
Expert VSL (Video Sales Letter) and product marketing video storyboard writer. Use when creating sales videos, product demos, explainer videos, social media video content, or marketing video scripts. Use when asked to "write a video script", "create a VSL", "storyboard a sales video", or "script a product demo". Produces storyboard scripts optimized for handoff to motion designer and Remotion video production.
npx skills add ncklrs/startup-os-skills --skill vsl-storyboard-writer
Expert video sales letter and product marketing script writer specializing in high-converting video content that drives action. This skill bridges copywriting and video production, creating storyboard scripts ready for motion design implementation.
Great video sales scripts combine three elements:
When invoked, this skill guides you through creating storyboard scripts that include:
/motion-designer skillThe output is a complete storyboard script that feeds directly into the motion designer workflow for Remotion implementation.
Choose framework based on video length and objective:
| Formula | Best For | Duration | Structure |
|---|---|---|---|
| Hook-CTA | Social media ads | 15-30s | Problem → Solution → CTA |
| PAS | Cold traffic | 30-90s | Problem → Agitation → Solution |
| AIDA | Product demos | 60-120s | Attention → Interest → Desire → Action |
| VSL Classic | Sales pages | 3-10min | Story → Problem → Solution → Proof → Offer → CTA |
| The Explainer | Education-first | 60-180s | Context → How it works → Benefits → CTA |
First 5 seconds determine 80% of watch-through rate.
Hook Types:
| Duration | Type | Goal | Key Metrics |
|---|---|---|---|
| 6-15s | Micro-content | Awareness, virality | Shares, engagement |
| 15-30s | Social ads | Traffic, interest | CTR, view-through |
| 30-60s | Product teasers | Demo requests | Click rate |
| 60-90s | Explainers | Understanding | Watch time |
| 90-180s | Full demos | Trial signups | Conversion rate |
| 3-10min | VSL sales videos | Purchase decisions | Sales |
Attention (0-15%):
Interest (15-40%):
Desire (40-80%):
Action (80-100%):
Problem (0-25%):
Agitate (25-50%):
Solution (50-100%):
When creating a storyboard, use this structure:
For each scene:
Here's a complete template for quick reference:
This skill produces storyboard scripts that the /motion-designer skill uses to create technical video specifications:
Storyboard Script (this skill) → Video Spec (motion-designer) → Remotion Implementation (dev)
When creating storyboards:
Formula: Hook → Value → CTA
Formula: Context → Demo → Benefits → CTA
Formula: Story → Problem → Solution → Proof → Offer → Close
Common objections to address in order:
Before finalizing a storyboard script:
Hook & Structure:
Copy & Messaging:
Conversion Elements:
Production Readiness:
Integration:
For detailed guidance on specific aspects:
## Story Arc
**Hook (0-Xs)**: [How we grab attention]
**Build (Xs-Ys)**: [How we build interest/desire]
**Peak (Ys-Zs)**: [Climax / main value proposition]
**Close (Zs-End)**: [CTA and resolution]
## Emotional Journey
Start: [Frustrated / Curious / Overwhelmed]
→ Middle: [Hopeful / Intrigued]
→ End: [Confident / Excited to act]## Scene N: [Scene Name] (Xs - Ys, Duration: Zs)
**Narrative Purpose**: [Why this scene exists in the story]
**On-Screen Copy**:
"[Exact text that appears on screen]"
[Additional text elements]
**Voiceover Script** (Optional):
"[Exact words spoken, if using VO]"
**Visual Description**:
[What viewers see - specific enough for motion designer]
- Background elements
- Main focal point
- Supporting visuals
- Text treatment
**Viewer Psychology**:
[What the viewer should think/feel at this moment]
- Emotional state we're creating
- Objection we're handling (if applicable)
- Desire we're building
**Sales Elements**:
[Any conversion tactics used]
- Social proof placement
- Scarcity/urgency indicator
- Risk reversal
- Benefit emphasis
- Objection handling
**Transition to Next**:
[How this scene flows to the next - why it makes sense]
**Motion Designer Notes**:
[Specific animation suggestions or requirements]
- Timing emphasis (fast/slow)
- Style notes (bold/subtle)
- Key moments to emphasize## Assets Needed
- [ ] Logo files
- [ ] Product screenshots/mockups
- [ ] Customer photos (if using testimonials)
- [ ] Data visualization elements
- [ ] Icons
## Copy Elements
- Headlines: [List all]
- Subheads: [List all]
- CTAs: [List all instances]
- Social proof quotes: [List all]
## Brand Guidelines
- Voice: [Professional / Casual / Technical / Friendly]
- Tone: [Urgent / Calm / Exciting / Authoritative]
- Restrictions: [Any copy or visual rules]# [Video Title]
**Type**: Product Demo VSL
**Duration**: 90 seconds
**Objective**: Trial signups
**Framework**: AIDA
**Target**: [Persona]
## Story Arc
Hook (0-5s): Problem question
Build (5-30s): Agitate pain, show solution
Peak (30-70s): Demo + social proof
Close (70-90s): CTA + urgency
---
## Scene 1: Hook (0-5s)
**On-Screen Copy**:
"Spending hours on [task]?"
**Visual**: [Description]
**Psychology**: Immediate identification with pain
**Sales Element**: Problem recognition
**Transition**: Visual chaos → order
---
## Scene 2: Agitation (5-15s)
**On-Screen Copy**:
"While your competitors move faster?"
**Visual**: [Description]
**Psychology**: FOMO, urgency of problem
**Sales Element**: Cost of inaction
**Transition**: Dark → light
---
[Continue for all scenes...]Scene 1 (0-3s): Bold question or problem
Scene 2 (3-12s): Show solution in action (demo)
Scene 3 (12-20s): Single benefit + social proof number
Scene 4 (20-30s): Simple CTAScene 1 (0-5s): Relatable problem hook
Scene 2 (5-15s): Why existing solutions fail
Scene 3 (15-30s): Introduce your solution
Scene 4 (30-50s): Show it working (3 key features)
Scene 5 (50-70s): Transformation / benefits
Scene 6 (70-80s): Social proof
Scene 7 (80-90s): Clear CTAAct 1 - Setup (0-45s):
- Personal story or customer story
- Establish credibility
- Introduce problem
Act 2 - Problem (45s-90s):
- Deep dive into pain points
- Why current solutions don't work
- Cost of status quo
Act 3 - Solution (90s-180s):
- Introduce product/service
- Unique mechanism
- How it works (demo)
- Key benefits
Act 4 - Proof (180s-240s):
- Case studies
- Testimonials
- Results/data
- Objection handling
Act 5 - Offer (240s-270s):
- What you get
- Pricing
- Bonuses
- Guarantee
Act 6 - Close (270s-300s):
- Urgency/scarcity
- Final CTA
- Reminder of transformation