$npx -y skills add ncklrs/startup-os-skills --skill vsl-storyboard-writerExpert 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 vi
| 1 | # VSL Storyboard Writer |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | ## Philosophy |
| 6 | |
| 7 | Great video sales scripts combine three elements: |
| 8 | |
| 9 | 1. **Sales psychology** — Understanding what drives decisions at each stage |
| 10 | 2. **Visual storytelling** — Every scene advances both narrative and conversion |
| 11 | 3. **Production readiness** — Scripts that motion designers can implement immediately |
| 12 | |
| 13 | ## How This Skill Works |
| 14 | |
| 15 | When invoked, this skill guides you through creating storyboard scripts that include: |
| 16 | |
| 17 | - **Hook-focused openings** — Proven patterns to grab attention in 3-5 seconds |
| 18 | - **Narrative flow** — Story structures that build desire and urgency |
| 19 | - **Scene-by-scene scripts** — Visual descriptions, copy, timing, and rationale |
| 20 | - **Conversion optimization** — Strategic placement of social proof, objection handling, CTAs |
| 21 | - **Motion design handoff** — Format compatible with `/motion-designer` skill |
| 22 | |
| 23 | The output is a complete storyboard script that feeds directly into the motion designer workflow for Remotion implementation. |
| 24 | |
| 25 | ## Core Frameworks |
| 26 | |
| 27 | ### VSL Formula Hierarchy |
| 28 | |
| 29 | Choose framework based on video length and objective: |
| 30 | |
| 31 | | Formula | Best For | Duration | Structure | |
| 32 | |---------|----------|----------|-----------| |
| 33 | | **Hook-CTA** | Social media ads | 15-30s | Problem → Solution → CTA | |
| 34 | | **PAS** | Cold traffic | 30-90s | Problem → Agitation → Solution | |
| 35 | | **AIDA** | Product demos | 60-120s | Attention → Interest → Desire → Action | |
| 36 | | **VSL Classic** | Sales pages | 3-10min | Story → Problem → Solution → Proof → Offer → CTA | |
| 37 | | **The Explainer** | Education-first | 60-180s | Context → How it works → Benefits → CTA | |
| 38 | |
| 39 | ### The 5-Second Hook Formula |
| 40 | |
| 41 | First 5 seconds determine 80% of watch-through rate. |
| 42 | |
| 43 | **Hook Types**: |
| 44 | 1. **Question Hook** — "What if [desired outcome] was actually easy?" |
| 45 | 2. **Problem Hook** — "Tired of [pain point]?" |
| 46 | 3. **Curiosity Hook** — "This [simple thing] changed everything" |
| 47 | 4. **Pattern Interrupt** — Unexpected visual or statement |
| 48 | 5. **Social Proof Hook** — "10,000 teams already [outcome]" |
| 49 | 6. **Demonstration Hook** — Show impressive result immediately |
| 50 | |
| 51 | ### Video Length Guidelines |
| 52 | |
| 53 | | Duration | Type | Goal | Key Metrics | |
| 54 | |----------|------|------|-------------| |
| 55 | | 6-15s | Micro-content | Awareness, virality | Shares, engagement | |
| 56 | | 15-30s | Social ads | Traffic, interest | CTR, view-through | |
| 57 | | 30-60s | Product teasers | Demo requests | Click rate | |
| 58 | | 60-90s | Explainers | Understanding | Watch time | |
| 59 | | 90-180s | Full demos | Trial signups | Conversion rate | |
| 60 | | 3-10min | VSL sales videos | Purchase decisions | Sales | |
| 61 | |
| 62 | ### The AIDA Arc for VSL |
| 63 | |
| 64 | **Attention (0-15%)**: |
| 65 | - Hook with problem or question |
| 66 | - Pattern interrupt |
| 67 | - Relatable scenario |
| 68 | |
| 69 | **Interest (15-40%)**: |
| 70 | - Agitate the problem |
| 71 | - Show why current solutions fail |
| 72 | - Introduce unique mechanism |
| 73 | |
| 74 | **Desire (40-80%)**: |
| 75 | - Demonstrate solution in action |
| 76 | - Social proof and testimonials |
| 77 | - Paint the transformation |
| 78 | - Handle objections |
| 79 | |
| 80 | **Action (80-100%)**: |
| 81 | - Clear, specific offer |
| 82 | - Urgency or scarcity |
| 83 | - Risk reversal |
| 84 | - Multiple CTAs |
| 85 | |
| 86 | ### The PAS Framework |
| 87 | |
| 88 | **Problem (0-25%)**: |
| 89 | - Identify specific, relatable pain point |
| 90 | - Use "you" language |
| 91 | - Visual: Show the struggle |
| 92 | |
| 93 | **Agitate (25-50%)**: |
| 94 | - Why this problem is getting worse |
| 95 | - Cost of inaction |
| 96 | - Failed alternatives |
| 97 | - Visual: Amplify the frustration |
| 98 | |
| 99 | **Solution (50-100%)**: |
| 100 | - Introduce your product/service |
| 101 | - Show it working |
| 102 | - Proof it works |
| 103 | - Easy next step |
| 104 | - Visual: Transformation moment |
| 105 | |
| 106 | ## Storyboard Script Format |
| 107 | |
| 108 | When creating a storyboard, use this structure: |
| 109 | |
| 110 | ### 1. Script Header |
| 111 | |
| 112 | ```markdown |
| 113 | # [Video Title] |
| 114 | |
| 115 | **Type**: [VSL / Explainer / Product Demo / Social Ad] |
| 116 | **Duration**: [Total seconds] |
| 117 | **Objective**: [Primary conversion goal] |
| 118 | **Target Audience**: [Specific persona] |
| 119 | **Framework**: [AIDA / PAS / Hook-CTA / etc.] |
| 120 | |
| 121 | ## Key Message |
| 122 | [Single sentence: What should viewers remember?] |
| 123 | |
| 124 | ## Desired Action |
| 125 | [Specific CTA: What should viewers do?] |
| 126 | ``` |
| 127 | |
| 128 | ### 2. Script Overview |
| 129 | |
| 130 | ```markdown |
| 131 | ## Story Arc |
| 132 | |
| 133 | **Hook (0-Xs)**: [How we grab attention] |
| 134 | **Build (Xs-Ys)**: [How we build interest/desire] |
| 135 | **Peak (Ys-Zs)**: [Climax / main value proposition] |
| 136 | **Close (Zs-End)**: [CTA and resolution] |
| 137 | |
| 138 | ## Emotional Journey |
| 139 | Start: [Frustrated / Curious / Overwhelmed] |
| 140 | → Middle: [Hopeful / Intrigued] |
| 141 | → End: [Confident / Excited to act] |
| 142 | ``` |
| 143 | |
| 144 | ### 3. Scene-by-Scene Storyboard |
| 145 | |
| 146 | For each sce |