Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ncklrs avatar

Vsl Storyboard Writer

  • 376 installs
  • 37 repo stars
  • Updated February 26, 2026
  • ncklrs/startup-os-skills

vsl-storyboard-writer is a Claude Code skill that drafts production-ready VSL, demo, and ad storyboard scripts with conversion frameworks and scene direction for developers and marketers handing work to motion-designer a

About

vsl-storyboard-writer is an ncklrs/startup-os-skills Claude Code skill for high-converting video sales letter and product marketing storyboards. It selects among five frameworks—Hook-CTA, PAS, AIDA, VSL Classic, and The Explainer—mapped to durations from 15-second social ads through 3–10 minute sales videos. The skill documents six hook types including question, problem, curiosity, pattern interrupt, social proof, and demonstration hooks, emphasizing a 3–5 second attention window. Output includes script headers, story arcs, scene-by-scene copy, visual descriptions, psychology notes, and motion-designer handoff fields. The documented pipeline flows VSL Storyboard Writer → Motion Designer → Remotion Implementation. Eight supplementary rule files cover hooks, frameworks, pacing, social proof, objections, CTAs, visual storytelling, and handoff formatting. Use when scripting product demos, explainers, or paid social video before video engineering begins.

  • Pipeline handoff: VSL Storyboard Writer → motion-designer → Remotion implementation
  • Scene-by-scene breakdowns with copy, psychology, and visual direction for producers
  • Rule library including storyboard template, vsl-hooks, and vsl-frameworks (AIDA, PAS, etc.)
  • Covers VSLs, product demos, explainers, and social media video ads from one skill entry
  • Outputs optimized for conversion strategy plus production requirements, not bare voiceover text

Vsl Storyboard Writer by the numbers

  • 376 all-time installs (skills.sh)
  • +7 installs in the week ending Jul 26, 2026 (Skillselion tracking)
  • Ranked #215 of 853 Sales & Marketing skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ncklrs/startup-os-skills --skill vsl-storyboard-writer

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs376
repo stars37
Security audit3 / 3 scanners passed
Last updatedFebruary 26, 2026
Repositoryncklrs/startup-os-skills

How do you storyboard a product demo video?

Draft production-ready VSL, demo, and ad storyboard scripts with hooks, frameworks, and scene direction for handoff to motion-designer and Remotion.

Who is it for?

Developers or PMs producing product demo, explainer, or VSL scripts destined for motion-designer and Remotion video implementation pipelines.

Skip if: Teams needing only static landing page copy without video production should use copywriting skills instead of VSL storyboard formatting.

When should I use this skill?

User asks to write a VSL, product demo script, video storyboard, or social ad storyboard for Remotion handoff.

What you get

Complete storyboard script with scene timings, on-screen copy, visual direction, asset list, and motion-designer handoff notes.

  • Storyboard script
  • Scene timing breakdown
  • Asset requirements list

By the numbers

  • Documents 5 VSL frameworks in the formula hierarchy table
  • Lists 6 hook types in the 5-second hook formula
  • References 8 supplementary rule files for hooks, pacing, CTAs, and handoff

Files

SKILL.mdMarkdownGitHub ↗

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.

Philosophy

Great video sales scripts combine three elements:

1. Sales psychology — Understanding what drives decisions at each stage 2. Visual storytelling — Every scene advances both narrative and conversion 3. Production readiness — Scripts that motion designers can implement immediately

How This Skill Works

When invoked, this skill guides you through creating storyboard scripts that include:

  • Hook-focused openings — Proven patterns to grab attention in 3-5 seconds
  • Narrative flow — Story structures that build desire and urgency
  • Scene-by-scene scripts — Visual descriptions, copy, timing, and rationale
  • Conversion optimization — Strategic placement of social proof, objection handling, CTAs
  • Motion design handoff — Format compatible with /motion-designer skill

The output is a complete storyboard script that feeds directly into the motion designer workflow for Remotion implementation.

Core Frameworks

VSL Formula Hierarchy

Choose framework based on video length and objective:

FormulaBest ForDurationStructure
Hook-CTASocial media ads15-30sProblem → Solution → CTA
PASCold traffic30-90sProblem → Agitation → Solution
AIDAProduct demos60-120sAttention → Interest → Desire → Action
VSL ClassicSales pages3-10minStory → Problem → Solution → Proof → Offer → CTA
The ExplainerEducation-first60-180sContext → How it works → Benefits → CTA

The 5-Second Hook Formula

First 5 seconds determine 80% of watch-through rate.

Hook Types: 1. Question Hook — "What if [desired outcome] was actually easy?" 2. Problem Hook — "Tired of [pain point]?" 3. Curiosity Hook — "This [simple thing] changed everything" 4. Pattern Interrupt — Unexpected visual or statement 5. Social Proof Hook — "10,000 teams already [outcome]" 6. Demonstration Hook — Show impressive result immediately

Video Length Guidelines

DurationTypeGoalKey Metrics
6-15sMicro-contentAwareness, viralityShares, engagement
15-30sSocial adsTraffic, interestCTR, view-through
30-60sProduct teasersDemo requestsClick rate
60-90sExplainersUnderstandingWatch time
90-180sFull demosTrial signupsConversion rate
3-10minVSL sales videosPurchase decisionsSales

The AIDA Arc for VSL

Attention (0-15%):

  • Hook with problem or question
  • Pattern interrupt
  • Relatable scenario

Interest (15-40%):

  • Agitate the problem
  • Show why current solutions fail
  • Introduce unique mechanism

Desire (40-80%):

  • Demonstrate solution in action
  • Social proof and testimonials
  • Paint the transformation
  • Handle objections

Action (80-100%):

  • Clear, specific offer
  • Urgency or scarcity
  • Risk reversal
  • Multiple CTAs

The PAS Framework

Problem (0-25%):

  • Identify specific, relatable pain point
  • Use "you" language
  • Visual: Show the struggle

Agitate (25-50%):

  • Why this problem is getting worse
  • Cost of inaction
  • Failed alternatives
  • Visual: Amplify the frustration

Solution (50-100%):

  • Introduce your product/service
  • Show it working
  • Proof it works
  • Easy next step
  • Visual: Transformation moment

Storyboard Script Format

When creating a storyboard, use this structure:

1. Script Header

# [Video Title]

**Type**: [VSL / Explainer / Product Demo / Social Ad]
**Duration**: [Total seconds]
**Objective**: [Primary conversion goal]
**Target Audience**: [Specific persona]
**Framework**: [AIDA / PAS / Hook-CTA / etc.]

## Key Message
[Single sentence: What should viewers remember?]

## Desired Action
[Specific CTA: What should viewers do?]

2. Script Overview

## 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]

3. Scene-by-Scene Storyboard

For each scene:

## 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

4. Production Requirements

## 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]

VSL Storyboard Template

Here's a complete template for quick reference:

# [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...]

Integration with Motion Designer

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: 1. Focus on copy, messaging, and conversion strategy 2. Provide visual direction but not technical specs 3. Include timing guidance but not frame-by-frame details 4. Emphasize WHY each scene exists (narrative + conversion) 5. Let motion designer handle HOW to execute visually

Common Video Types

Short-Form Social (15-30s)

Formula: Hook → Value → CTA

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 CTA

Product Explainer (60-90s)

Formula: Context → Demo → Benefits → CTA

Scene 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 CTA

Full VSL (3-5min)

Formula: Story → Problem → Solution → Proof → Offer → Close

Act 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

Conversion Optimization Principles

Social Proof Placement

  • Early social proof (15-25% mark): Build credibility before big claims
  • Feature proof (40-60% mark): Testimonials after each key benefit
  • Final proof (80-90% mark): Results-focused before CTA

Objection Handling Sequence

Common objections to address in order:

1. Does it work? → Demo + proof 2. Will it work for me? → Use cases / customer stories 3. Is it too complicated? → Show simplicity 4. Is it worth the money? → ROI / value equation 5. What if it doesn't work? → Guarantee / risk reversal

CTA Best Practices

  • Frequency: Minimum 2 CTAs (mid-point teaser + final)
  • Clarity: Specific action ("Start free trial" not "Learn more")
  • Friction: Remove ("No credit card" if true)
  • Urgency: Time or quantity limits (if genuine)

Anti-Patterns

Script-Level

  • Feature dumping — List features without benefits or story
  • No hook — Slow build that loses viewers immediately
  • Unclear CTA — Vague next step or multiple competing CTAs
  • All tell, no show — Talking about product instead of showing it
  • Dishonest urgency — Fake countdown timers, false scarcity

Scene-Level

  • Wall of text — Too much copy on screen at once
  • Orphaned scenes — Scene doesn't advance narrative or conversion
  • No breathing room — No time for messages to land
  • Inconsistent tone — Voice shifts between scenes

Production

  • Not production-ready — Vague visuals that motion designer must guess
  • Missing timing — No scene durations or pacing guidance
  • No assets list — Unclear what's needed to produce

Quality Checklist

Before finalizing a storyboard script:

Hook & Structure:

  • [ ] Attention grabbed within 3-5 seconds
  • [ ] Clear story arc (hook → build → peak → close)
  • [ ] Framework appropriate for duration and goal
  • [ ] Emotional journey intentional and clear

Copy & Messaging:

  • [ ] Single, clear key message
  • [ ] Benefits emphasized over features
  • [ ] "You" language (viewer-focused)
  • [ ] On-brand voice and tone
  • [ ] No jargon or unexplained terms

Conversion Elements:

  • [ ] Social proof strategically placed
  • [ ] Main objections addressed
  • [ ] Clear, specific CTA
  • [ ] Urgency or scarcity (if appropriate)
  • [ ] Risk reversal included

Production Readiness:

  • [ ] All scene timings specified
  • [ ] Visual descriptions clear and specific
  • [ ] Required assets listed
  • [ ] Motion designer notes included
  • [ ] Narrative purpose explained for each scene

Integration:

  • [ ] Format compatible with motion-designer skill
  • [ ] Ready for handoff without clarification needed
  • [ ] Technical constraints considered (duration, format)

When to Consult Rules

For detailed guidance on specific aspects:

  • rules/vsl-hooks.md — Hook formulas and patterns
  • rules/vsl-frameworks.md — Detailed framework applications
  • rules/script-pacing.md — Timing and rhythm
  • rules/social-proof-strategy.md — Testimonial and proof placement
  • rules/objection-handling.md — Addressing buyer concerns
  • rules/cta-optimization.md — Call-to-action best practices
  • rules/visual-storytelling.md — Show don't tell principles
  • rules/motion-designer-handoff.md — Production-ready formatting

Expert Tips

Script Writing

  • Start with the CTA, work backwards (what journey gets them there?)
  • Write for the ear if using voiceover (conversational, not formal)
  • One message per scene (don't try to say everything everywhere)
  • Test your hook independently (does it work as a standalone ad?)

Conversion Psychology

  • Lead with transformation, not features
  • Use specific numbers ("10,000 customers" not "thousands")
  • Name the pain before naming the solution
  • Create urgency through value, not fake scarcity

Production Planning

  • Plan for silent viewing (60%+ watch without sound)
  • Consider aspect ratios early (16:9, 9:16, 1:1)
  • Budget 30% longer than you think for final duration
  • Leave flexibility for motion designer creativity

Collaboration

  • Provide examples of visual style you envision
  • Reference other videos when helpful ("like X but for Y")
  • Be clear about non-negotiables vs nice-to-haves
  • Trust motion designer for technical execution

Related skills

How it compares

Use for video storyboards bound for Remotion; use plain copy skills for non-video landing pages.

FAQ

What does vsl-storyboard-writer output for video production?

vsl-storyboard-writer produces production-ready storyboard scripts with script headers, story arcs, scene-by-scene on-screen copy, visual descriptions, viewer psychology notes, sales elements, timing, asset lists, and motion-designer handoff notes formatted for the motion-designe

Which video frameworks does vsl-storyboard-writer support?

vsl-storyboard-writer documents five frameworks—Hook-CTA for 15–30s ads, PAS for cold traffic, AIDA for demos, VSL Classic for 3–10 minute sales videos, and The Explainer for education-first content—each mapped to recommended durations and narrative structure.

Is Vsl Storyboard Writer safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Sales & Marketingcontentdistribution

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.