video-script

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

---
name: video-script
description: "Write a production-ready video script — 3 hook variants, timestamped dialogue with visual and audio direction columns, CTA placement map, retention notes, accessibility package, and thumbnail concepts. Detects whether the script is organic or an ad: organic scripts declare a search/browse discovery intent, ad scripts inherit objective, audience, and offer from campaign context and follow per-format rules (6s bumper, 15s skippable, 30s spot, UGC-style with disclosure). Triggers on \"/digital-marketing-pro:video-script\", \"write a YouTube script about X\", \"script a 15-second ad\", \"TikTok video for our launch\", \"explainer video script\". Reads the brand profile and campaign briefs; every script passes the /digital-marketing-pro:check gate before delivery."
argument-hint: "[topic or format]"
---

# /digital-marketing-pro:video-script

## Purpose

Write a production-ready video marketing script with hook variants, timestamps, visual direction notes, CTA placement, and platform-specific formatting. Produces a complete script package ready for production with visual and audio columns, accessibility notes, and thumbnail concepts.

## Input Required

The user must provide (or will be prompted for):

- **Video type**: The format of the video — ad spot, explainer, testimonial, product demo, social short, educational tutorial, brand story, or event recap
- **Target platform**: Where the video will be published — YouTube, TikTok, Instagram Reels, LinkedIn, YouTube Shorts, Facebook, or multi-platform
- **Target length**: Desired duration — 15s, 30s, 60s, 90s, 2-3 min, 5-10 min, or long-form 10+ min
- **Key message or topic**: The core idea, value proposition, or subject matter the video must communicate
- **Call to action**: What the viewer should do after watching — visit URL, subscribe, purchase, sign up, download, follow, etc.
- **Target audience**: Who the video is for — demographics, psychographics, awareness level, and platform behavior
- **Brand tone**: Desired tone and energy level — professional, casual, humorous, inspirational, educational, urgent, or conversational
- **Available assets**: What production resources are available — on-camera talent, b-roll footage, product samples, graphics/animation capability, studio vs. location, screen recordings
- **Competitor video references**: Optional — links or descriptions of competitor or aspirational videos to benchmark against
- **Performance goals**: What success looks like — views, watch-through rate, click-through rate, conversions, engagement, or brand lift

## Process

1. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply brand voice, compliance rules for target markets (`skills/context-engine/compliance-rules.md`), and industry context. **Also check for guidelines** at `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` — if present, load restrictions and relevant category files. Check for custom templates at `~/.claude-marketing/brands/{slug}/templates/`. Check for agency SOPs at `~/.claude-marketing/sops/`. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
2. **Determine platform specs and format constraints**: Reference platform-specific requirements — aspect ratio (16:9, 9:16, 1:1), max duration, safe zones for text overlays, caption placement areas, and native content conventions. Apply platform algorithm preferences (e.g., TikTok favors native-feeling content, LinkedIn rewards professional storytelling, YouTube prioritizes watch time).
2.4. **Identify the script class — organic or ad — and load campaign context**: These are different disciplines with different physics. **Organic** content earns its audience (discovery intent, step 2.5). **Ads** buy theirs, so the craft is about what happens inside a paid, often skippable slot. If this script belo