$npx -y skills add indranilbanerjee/contentforge --skill cf-video-scriptProduce video scripts with hooks, scenes, and B-roll for YouTube, TikTok, Reels, and explainers.
| 1 | # Video Script Production |
| 2 | |
| 3 | Transform a topic or existing article into a production-ready video script with timestamps, scene directions, B-roll shot lists, on-screen text, and music recommendations -- optimized for YouTube, TikTok, Instagram Reels, or explainer video formats. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | Use `/contentforge:cf-video-script` when you need: |
| 8 | - **YouTube scripts** (3-10 min) with SEO-optimized titles, descriptions, and chapter timestamps |
| 9 | - **TikTok scripts** (30-60s) with fast-cut pacing and trending audio hooks |
| 10 | - **Instagram Reels scripts** (30-60s) with vertical format and caption-driven storytelling |
| 11 | - **Explainer videos** (3-5 min) with clear visual directions and professional pacing |
| 12 | - **Video adaptations** of existing ContentForge articles, blogs, or whitepapers |
| 13 | |
| 14 | **Not for:** Raw creative brainstorming (use `/contentforge:create-content` first for research), live stream outlines, podcast scripts. |
| 15 | |
| 16 | ## Supported Platforms & Lengths |
| 17 | |
| 18 | | Platform | Supported Lengths | Aspect Ratio | Key Characteristics | |
| 19 | |----------|------------------|--------------|-------------------| |
| 20 | | **YouTube** | 3min, 5min, 10min | 16:9 landscape | SEO titles, end screens, mid-roll breaks | |
| 21 | | **YouTube Shorts** | 15s, 30s, 60s, up to 3min | 9:16 vertical | Hook in 1-2s, loopable ending, feed-native captions | |
| 22 | | **TikTok** | 30s, 60s, long-form 3min-10min | 9:16 vertical | Hook in 1s, fast cuts, trending audio; long-form uses chaptered storytelling | |
| 23 | | **Instagram Reels** | 30s, 60s | 9:16 vertical | Captions required, visual-first storytelling | |
| 24 | | **Explainer** | 3min, 5min | 16:9 landscape | Slower pace, professional graphics, clear narration | |
| 25 | |
| 26 | ## Required Inputs |
| 27 | |
| 28 | **Minimum Required:** |
| 29 | - **Topic or Source** -- Either a topic string ("AI in Healthcare 2026") or a ContentForge article URL/path |
| 30 | - **Platform** -- `youtube`, `youtube-shorts`, `tiktok`, `instagram`, or `explainer` |
| 31 | - **Video Length** -- `15s`, `30s`, `60s`, `3min`, `5min`, or `10min` (platform-dependent; see table above) |
| 32 | |
| 33 | **Optional:** |
| 34 | - **Tone** -- `educational`, `entertaining`, `promotional`, or `storytelling` (defaults to platform standard) |
| 35 | - **Brand** -- Brand profile for voice consistency (recommended) |
| 36 | - **Target Audience** -- Who this video is for (e.g., "Marketing managers, 25-45") |
| 37 | - **Primary Keyword** -- For YouTube SEO optimization |
| 38 | - **CTA** -- Specific call-to-action (defaults to platform-appropriate CTA) |
| 39 | - **Speaker** -- On-camera host name, or "voiceover only" |
| 40 | |
| 41 | ## How to Use |
| 42 | |
| 43 | ### Interactive Mode |
| 44 | ``` |
| 45 | /contentforge:cf-video-script |
| 46 | ``` |
| 47 | **Prompts you for:** |
| 48 | 1. Topic or source article URL |
| 49 | 2. Platform (YouTube / TikTok / Instagram / Explainer) |
| 50 | 3. Video length |
| 51 | 4. Tone |
| 52 | 5. Brand profile (optional) |
| 53 | |
| 54 | ### Quick Mode |
| 55 | ``` |
| 56 | /contentforge:cf-video-script "AI in Healthcare: 2026 Trends" --platform=youtube --length=5min --tone=educational --brand=AcmeMed |
| 57 | ``` |
| 58 | |
| 59 | ### From Existing Article |
| 60 | ``` |
| 61 | /contentforge:cf-video-script --source="https://drive.google.com/file/d/ABC123" --platform=tiktok --length=60s --tone=entertaining |
| 62 | ``` |
| 63 | Extracts key points from the article and restructures for video format. |
| 64 | |
| 65 | ## What Happens |
| 66 | |
| 67 | ### Phase 1: Content Research & Extraction (2-4 minutes) |
| 68 | - If topic provided: Research Agent gathers video-friendly data points, statistics, examples, and competitor video analysis |
| 69 | - If source article provided: Extracts key messages, data points, quotes, and visual opportunities |
| 70 | - Identifies the single strongest hook (statistic, question, or bold claim) |
| 71 | - Maps content to target video length (word count budget based on 120-150 words/minute dialogue) |
| 72 | - **Quality Gate:** Hook identified, word budget calculated, key points mapped to scenes |
| 73 | |
| 74 | ### Phase 2: Script Structure (2-3 minutes) |
| 75 | - Content Drafter builds script following `templates/content-types/video-script-structure.md` |
| 76 | - Allocates time to each section: |
| 77 | - **HOOK:** First 3 seconds (TikTok: 1 second) |
| 78 | - **INTRO:** 10-15% of total length |
| 79 | - **MAIN CONTENT:** 60-70% split across scenes |
| 80 | - **CTA:** 10-15% of total length |
| 81 | - **OUTRO:** 5-10% (YouTube only) |
| 82 | - Creates scene breakdown with timestamps |
| 83 | - **Quality Gate:** All sections allocated, timestamps continuous, word count within budget |
| 84 | |
| 85 | ### Phase 3: Scene Writing (3-5 minutes) |
| 86 | - Writes each scene with: |
| 87 | - **Dialogue/Narration:** What the speaker says (timed to 120-150 words/min) |
| 88 | - **On-Screen Text:** Key phrases, statistics, bullet points viewers see |
| 89 | - **B-Roll Directions:** Specific visual descriptions for each segment |
| 90 | - **Music/SFX:** Mood, tempo, and transition sound suggestions |
| 91 | - Applies platform-specific style: |
| 92 | - YouTube: Conversational, direct address, pattern interrupts every 30-60s |
| 93 | - TikTok: Punchy, fast-paced, text-heavy, trending audio references |
| 94 | - Instagram: Visual-first, caption storytelling, aesthetic emphasis |
| 95 | - Explainer: Clear, measured pace, professio |