aiwg/agentic/code/frameworks/media-marketing-kit/templates/content/video-script-template.md

Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo

# Video Script Template

---

**Metadata**:
```yaml
id: CNT-006
template_name: Video Script Template
version: 1.0.0
category: Content
subcategory: Video Production
framework: Video Storytelling with Timing
related_templates:
  - STR-002 (Messaging Matrix)
  - BRD-002 (Voice & Tone Guide)
  - CNT-001 (Blog Post Template)
  - SOC-001 (Social Media Post Template)
primary_agents:
  - content-strategist
  - video-producer
  - copywriter
lifecycle_phase: Creation
status: active
```

---

## Purpose

This template provides a structured approach to writing video scripts with timing, shot descriptions, and production notes. Suitable for explainer videos, product demos, testimonials, social media videos, and video ads.

---

## Video Brief

### 1. Project Overview

**Video Title**: `[Working title - will be refined for SEO and clarity]`

**Video Type**:
- [ ] Explainer Video (educate on concept or problem/solution)
- [ ] Product Demo (showcase product features)
- [ ] Testimonial/Case Study (customer success story)
- [ ] Brand Story (company mission, values, culture)
- [ ] Tutorial/How-To (step-by-step instructions)
- [ ] Social Media Video (short-form, attention-grabbing)
- [ ] Video Ad (paid promotion, conversion-focused)
- [ ] Webinar/Presentation (long-form educational)
- [ ] Event Recap (highlights from event or conference)
- [ ] Other: `___________`

**Target Length**:
- [ ] :15 seconds (social ad, teaser)
- [ ] :30 seconds (social ad, product highlight)
- [ ] :60 seconds (explainer, demo)
- [ ] 1-2 minutes (tutorial, testimonial)
- [ ] 2-5 minutes (deep dive, case study)
- [ ] 5-10 minutes (webinar segment, comprehensive tutorial)
- [ ] 10+ minutes (full webinar, keynote, documentary)
- [ ] Custom: `[XX:XX minutes]`

**Delivery Date**: `YYYY-MM-DD`

**Video Team**:
- Producer: `[Name]`
- Director: `[Name]`
- Scriptwriter: `[Name]`
- Videographer: `[Name]`
- Editor: `[Name]`
- Voiceover Artist: `[Name or "On-camera talent"]`

### 2. Strategic Context

**Business Objective**:
`[What is the goal? Lead generation, brand awareness, product launch, education, conversion, etc.]`

**Target Audience**:
- **Primary**: `[Buyer persona - see STR-005 for profile]`
- **Platform**: `[YouTube, LinkedIn, Facebook, Instagram, Website, Email, Paid Ads, etc.]`
- **Stage in Buyer Journey**: `[Awareness / Consideration / Decision]`
- **Viewing Context**: `[Where/how will they watch? Mobile, desktop, sound on/off?]`

**Key Messages** (from STR-002 Messaging Matrix):
1. `[Primary message or value proposition]`
2. `[Secondary message or benefit]`
3. `[Tertiary message or call-to-action]`

**Tone & Style** (from BRD-002 Voice & Tone Guide):
- [ ] Professional/Corporate
- [ ] Friendly/Conversational
- [ ] Energetic/Upbeat
- [ ] Calm/Soothing
- [ ] Humorous/Playful
- [ ] Inspirational/Motivational
- [ ] Educational/Authoritative
- [ ] Other: `___________`

### 3. Distribution & SEO

**Primary Platform**: `[YouTube, LinkedIn, Facebook, Instagram, Website, etc.]`

**Platform Specs**:
- Aspect Ratio: `[16:9 (landscape), 9:16 (vertical), 1:1 (square), 4:5 (Instagram feed)]`
- Resolution: `[1080p, 4K, etc.]`
- File Format: `[MP4, MOV, etc.]`

**SEO (YouTube/Website)**:
- **Video Title** (60 chars): `[Include primary keyword]`
- **Description** (150-300 words): `[Include keywords, links, timestamps]`
- **Tags**: `[Keyword 1], [Keyword 2], [Keyword 3], [...]`
- **Thumbnail**: `[Custom thumbnail with text overlay and compelling visual]`

**Captions/Subtitles**:
- [ ] Auto-generated (YouTube, Facebook)
- [ ] SRT file (custom, accurate subtitles)
- [ ] Burned-in captions (for sound-off viewing)

### 4. Call-to-Action (CTA)

**Primary CTA**:
- Text: `[e.g., "Visit our website to learn more"]`
- Visual: `[On-screen text, button, end card]`
- Link: `[URL with UTM parameters: utm_source=youtube&utm_medium=video&utm_campaign=___]`

**Secondary CTA** (if applicable):
- Text: `[e.g., "Subscribe for more tips"]`
- Placement: `[End screen, mid-video annotation]`

### 5. Production Style

**Visual Style**:
- [ ] Live action (real people, locations)
- [ ] Animation (motion graphics, 2D/3D)
- [ ] Screen recording (software demo, tutorial)
- [ ] Hybrid (mix of live action and animation)
- [ ] Stock footage (b-roll with voiceover)
- [ ] Whiteboard/Illustrated explainer

**B-Roll/Supplemental Footage**:
- [ ] Product shots
- [ ] Customer testimonials
- [ ] Office/team footage
- [ ] Stock footage (licensed)
- [ ] Screen recordings
- [ ] Graphics/animations

**Music/Audio**:
- Background Music: `[Upbeat / Calm / Dramatic / None]`
- Sound Effects: `[Yes / No - describe if yes]`
- Voiceover: `[Professional VO / On-camera talent / AI voice]`

---

## Script Structure

### Timing Convention

**Format**: `[MM:SS]` (minutes:seconds) for total runtime; each scene/shot includes duration estimate.

**Example**:
```
[00:00-00:05] SCENE 1: Opening hook (5 seconds)
[00:05-00:15] SCENE 2: Problem statement (10 seconds)
...
```

**Note**: Timing is approximate and will be refined in editing. Average speaking pace is 150 words/minute (2.5 words/second).

---

## Full Video Script

### Title

**Working Title**: `[Video title for internal reference]`

**SEO Title** (for YouTube/website): `[60 chars max, keyword-rich]`

---

### [00:00-00:05] Opening Hook (5 seconds)

**Scene**: `[Describe visual: setting, characters, action]`

**Shot Type**: `[Wide / Medium / Close-up / Screen recording / Animation]`

**Visual Elements**:
- `[e.g., "Logo animation on branded background"]`
- `[e.g., "On-camera talent speaking directly to camera"]`
- `[e.g., "Product shot with dynamic zoom"]`

**Voiceover/Dialogue**:
```
[Exact script - 10-15 words max for 5 seconds]

Example: "Are you struggling to [problem]? You're not alone."
```

**On-Screen Text** (if applicable):
```
[Text overlay or graphic - e.g., "73% of marketers struggle with..."]
```

**Music/SFX**:
- Music: `[Starts - upbeat intro music fades in]`
- SFX: `[Whoosh sound for logo animation]`

**Production Notes**:
- `[Special instructions for director/editor - e.g., "Quick cuts for energy"]`

---

### [00:05-00:15] Problem Statement (10 seconds)

**Scene**: `[...]`

**Shot Type**: `[...]`

**Visual Elements**:
- `[...]`

**Voiceover/Dialogue**:
```
[25-30 words for 10 seconds]

Example: "Most teams waste hours every week on [task]. It's frustrating, inefficient, and costs your business thousands in lost productivity."
```

**On-Screen Text**:
```
[...]
```

**Music/SFX**:
- Music: `[Continues]`

**Production Notes**:
- `[...]`

---

### [00:15-00:35] Solution Introduction (20 seconds)

**Scene**: `[...]`

**Shot Type**: `[...]`

**Visual Elements**:
- `[e.g., "Product interface appears on screen"]`
- `[e.g., "Animated graphic shows before/after"]`

**Voiceover/Dialogue**:
```
[50-60 words for 20 seconds]

Example: "That's where [Product] comes in. Our platform automates [task], saving you time and reducing errors. With [key feature], you can [benefit]. It's easy to set up, integrates with your existing tools, and delivers results in minutes, not hours."
```

**On-Screen Text**:
```
[Product name and tagline]
```

**Music/SFX**:
- Music: `[Shifts to optimistic/hopeful tone]`
- SFX: `[UI click sounds as product demo plays]`

**Production Notes**:
- `[e.g., "Show smooth screen recording of product UI - no hesitation or errors"]`

---

### [00:35-00:50] Key Features/Benefits (15 seconds)

**Scene**: `[...]`

**Shot Type**: `[...]`

**Visual Elements**:
- `[e.g., "Split-screen showing 3 key features with icons"]`

**Voiceover/Dialogue**:
```
[35-40 words for 15 seconds]

Example: "Here's what makes [Product] different: One, [Feature 1] lets you [benefit]. Two, [Feature 2] ensures [benefit]. And three, [Feature 3] gives you [benefit]. All in one simple platform."
```

**On-Screen Text**:
```
Feature 1: [Benefit]
Feature 2: [Benefit]
Feature 3: [Benefit]
```

**Music/SFX**:
- Music: `[Continues]`
- SFX: `[Subtle "ping" for each feature reveal]`

**Production Notes**:
- `[Animated icons appear in sync with voiceover]`

---

### [00:50-01:05] Social Proof / Testimonial (15 seconds)

**Scene**: `[...]`

**Shot Type**: `[Medium shot of customer or text testimonial on screen]`

**Visual Elements**:
- `[e.g., "Customer photo with company logo"]`
- `[e.g., "Stat graphic: '10,000+ companies trust [Product]'"]`

**Voiceover/Dialogue**:
```
[35-40 words for 15 seconds]

Example: "Don't just take our word for it. Over 10,000 companies trust [Product] to streamline their workflows. As [Customer Name] from [Company] puts it, '[Short quote highlighting key benefit].'"
```

**On-Screen Text**:
```
"[Customer quote]"
— [Name, Title, Company]
```

**Music/SFX**:
- Music: `[Softens for testimonial authenticity]`

**Production Notes**:
- `[Use real customer photo and logo if available]`

---

### [01:05-01:20] Call-to-Action (15 seconds)

**Scene**: `[...]`

**Shot Type**: `[Close-up of CTA button or on-camera talent]`

**Visual Elements**:
- `[e.g., "Branded end card with CTA button"]`
- `[e.g., "QR code for mobile viewers"]`

**Voiceover/Dialogue**:
```
[35-40 words for 15 seconds]

Example: "Ready to save time and boost productivity? Start your free trial today—no credit card required. Visit [website] or click the link below to get started. Join thousands of teams already using [Product] to work smarter."
```

**On-Screen Text**:
```
Start Your Free Trial
👉 [Website URL]
```

**Music/SFX**:
- Music: `[Builds to upbeat, energetic finish]`

**Production Notes**:
- `[CTA button should be prominent and clickable (YouTube end screen)]`

---

### [01:20-01:25] Closing/Branding (5 seconds)

**Scene**: `[Branded outro]`

**Shot Type**: `[Full-screen logo animation]`

**Visual Elements**:
- `[Company logo with tagline]`
- `[Social media handles]`

**Voiceover/Dialogue**:
```
[Optional: "[Company name]. [Tagline]."]
```

**On-Screen Text**:
```
[Company Logo]
[Tagline]
[Social handles: @company]
```

**Music/SFX**:
- Music: `[Resolves with final chord or fade out]`

**Production Notes**:
- `[Clean, simple branding - don't overdo it]`

---

**TOTAL RUNTIME**: [01:25] (1 minute 25 seconds)

---

## Script Summary Table

| Timestamp | Scene | Duration | Key Message | Visual | Audio |
|-----------|-------|----------|-------------|--------|-------|
| 00:00-00:05 | Opening Hook | 5s | Grab attention with problem | Logo/product shot | VO: "Are you struggling..." |
| 00:05-00:15 | Problem | 10s | Amplify pain point | B-roll of frustrated user | VO: "Most teams waste hours..." |
| 00:15-00:35 | Solution | 20s | Introduce product/service | Product demo | VO: "That's where [Product]..." |
| 00:35-00:50 | Features | 15s | Highlight 3 key benefits | Split-screen graphics | VO: "Here's what makes us different..." |
| 00:50-01:05 | Social Proof | 15s | Build credibility | Customer testimonial | VO: "Over 10,000 companies..." |
| 01:05-01:20 | CTA | 15s | Drive action | CTA button/end card | VO: "Ready to save time?..." |
| 01:20-01:25 | Closing | 5s | Brand reinforcement | Logo animation | Music resolves |

**Total**: 1:25

---

## Production Checklist

### Pre-Production

**Script Finalization**:
- [ ] Script reviewed by stakeholders (marketing, product, legal if needed)
- [ ] Voiceover artist or on-camera talent confirmed
- [ ] Timing validated (read script aloud, adjust as needed)

**Storyboard**:
- [ ] Storyboard created (optional but recommended for complex videos)
- [ ] Key frames sketched or described

**Shot List**:
- [ ] All required shots listed (on-camera, b-roll, screen recordings, animations)
- [ ] Locations scouted (if live action)
- [ ] Props/equipment list finalized

**Assets Gathered**:
- [ ] Product logos, brand assets
- [ ] Stock footage licensed (if needed)
- [ ] Music licensed (Artlist, Epidemic Sound, etc.)
- [ ] Sound effects library

**Talent & Crew**:
- [ ] Voiceover artist booked
- [ ] On-camera talent confirmed (if applicable)
- [ ] Videographer/director scheduled
- [ ] Editor assigned

### Production

**Filming**:
- [ ] All scenes filmed according to shot list
- [ ] Multiple takes captured for each scene (safety)
- [ ] Audio quality confirmed (no background noise, clear VO)
- [ ] Lighting consistent and professional

**Screen Recordings** (if applicable):
- [ ] Product demo recorded in HD (1080p min)
- [ ] Mouse movements smooth and intentional
- [ ] No typos, errors, or distracting elements on screen

**Animation/Graphics** (if applicable):
- [ ] Motion graphics created (After Effects, Premiere, etc.)
- [ ] Graphics aligned with brand guidelines (colors, fonts)

### Post-Production

**Editing**:
- [ ] Video cut to script timing (tight pacing, no dead air)
- [ ] B-roll layered over voiceover where appropriate
- [ ] Transitions smooth and intentional (not overdone)
- [ ] Color grading applied for consistent look
- [ ] Audio mixed and balanced (VO clear, music at appropriate level)

**Graphics & Text**:
- [ ] On-screen text overlays added (name/titles, stats, CTAs)
- [ ] Lower-thirds for speakers (if applicable)
- [ ] CTA button/end card added
- [ ] Logo animation (opening and closing)

**Captions**:
- [ ] Subtitles/captions added (SRT file or burned-in)
- [ ] Captions reviewed for accuracy (no auto-caption errors)

**Sound Design**:
- [ ] Background music added and mixed (not overpowering VO)
- [ ] Sound effects added where appropriate
- [ ] Audio levels normalized (no clipping or distortion)

**QA (Quality Assurance)**:
- [ ] Full video reviewed for errors (typos, visual glitches, audio issues)
- [ ] Timing validated (matches script and target length)
- [ ] Brand compliance check (logo, colors, messaging align with guidelines)
- [ ] Accessibility check (captions, color contrast)

---

## Review Checklist

### Content Quality

- [ ] **Message Clarity**: Video clearly communicates key message in target timeframe
- [ ] **Accuracy**: All product claims, stats, and information verified
- [ ] **Voice & Tone**: Aligns with BRD-002 (Voice & Tone Guide)
- [ ] **Engagement**: Opening hook grabs attention within 3 seconds
- [ ] **Pacing**: No dead air, smooth flow, appropriate speed
- [ ] **CTA**: Clear, specific, and easy to act on

### Visual Quality

- [ ] **Resolution**: HD or better (1080p minimum, 4K if budget allows)
- [ ] **Lighting**: Professional, consistent, no harsh shadows
- [ ] **Framing**: Subjects properly framed, rule of thirds applied
- [ ] **Color**: Color grading consistent, brand colors used appropriately
- [ ] **Graphics**: On-brand, high-quality, not pixelated or low-res
- [ ] **Text Readability**: On-screen text large enough, high contrast, visible on mobile

### Audio Quality

- [ ] **VO Clarity**: Voiceover clear, no background noise or echo
- [ ] **Music**: Background music enhances (not distracts), properly licensed
- [ ] **Sound Effects**: SFX add value (not overdone or cheesy)
- [ ] **Audio Mix**: VO louder than music, no clipping or distortion
- [ ] **Captions**: Accurate, synchronized, properly formatted

### Technical Specs

- [ ] **Aspect Ratio**: Correct for platform (16:9, 9:16, 1:1, etc.)
- [ ] **File Format**: MP4 (H.264 codec recommended for web)
- [ ] **File Size**: Optimized for platform (<500MB for most platforms)
- [ ] **Thumbnail**: Custom thumbnail created (high-quality, branded, compelling)

### SEO & Distribution

- [ ] **Title**: SEO-optimized, includes keyword, <60 characters
- [ ] **Description**: Detailed, includes keywords, links, timestamps
- [ ] **Tags**: Relevant keywords added (YouTube, if applicable)
- [ ] **Captions**: SRT file uploaded or captions enabled
- [ ] **UTM Parameters**: CTA links tagged for tracking
- [ ] **End Screen**: YouTube end screen configured (CTA, related videos, subscribe)

### Legal & Compliance

- [ ] **Music Licensed**: Background music licensed (not copyrighted)
- [ ] **Stock Footage**: Stock footage licensed or rights secured
- [ ] **Talent Release**: On-camera talent signed release form
- [ ] **Disclaimers**: Required disclaimers included (if making claims)
- [ ] **Accessibility**: Captions provided, WCAG compliant

---

## Distribution Guidance

### Pre-Launch

**Platform Setup**:
- [ ] Upload to YouTube (unlisted for review, then public at launch)
- [ ] Upload to website (embedded on landing page or blog post)
- [ ] Upload to social platforms (LinkedIn, Facebook, Instagram, TikTok)
- [ ] Configure platform-specific settings (tags, captions, end screens)

**Landing Page** (if gating video):
- [ ] Create landing page with video and lead capture form
- [ ] Set up UTM tracking
- [ ] Configure thank you page with full video access

**Social Media Prep**:
- [ ] Create teaser clips (15-30 seconds) for social ads
- [ ] Draft social copy (3-5 variations) - see SOC-001
- [ ] Schedule posts across platforms

**Email Campaign**:
- [ ] Draft email announcement with video embed or thumbnail
- [ ] Segment list (who would benefit most?)
- [ ] Schedule send date

### Launch

**Publishing**:
- [ ] Video live on YouTube: `[URL]`
- [ ] Video embedded on website: `[URL]`
- [ ] Social posts published
- [ ] Email campaign sent

**Monitoring**:
- [ ] Track views, watch time, engagement (likes, comments, shares)
- [ ] Monitor click-through rate on CTA
- [ ] Track conversions (if CTA drives to landing page or form)

### Post-Launch (30-90 days)

**Promotion**:
- [ ] Reshare on social 2-3 times over first month (different angles)
- [ ] Include in email nurture sequences
- [ ] Add to sales presentations and outreach
- [ ] Embed in related blog posts
- [ ] Run paid ads (YouTube, LinkedIn, Facebook)

**Optimization**:
- [ ] Week 1: Review performance, adjust title/thumbnail if low CTR
- [ ] Week 4: Analyze watch time, identify drop-off points
- [ ] Month 2: Refresh social copy if engagement declining

**Performance Tracking**:
- **Views**: `XXX views in 30 days (target: XXX)`
- **Watch Time**: `XX% average watch completion (target: >50%)`
- **Engagement**: `XX% engagement rate (likes, comments, shares)`
- **Click-Through Rate**: `XX% CTA click-through`
- **Conversions**: `XX leads/demos/signups from video`

**Repurposing**:
- [ ] Create GIFs or short clips for social posts
- [ ] Transcribe and repurpose as blog post (see CNT-001)
- [ ] Use in email campaigns (embedded or as thumbnail link)
- [ ] Add to sales collateral library
- [ ] Create LinkedIn carousel from key frames

---

## Agent Notes

### For Content Strategist
- Align video topic with broader content strategy and campaign calendar
- Ensure video supports buyer journey stage (awareness, consideration, decision)
- Coordinate distribution across channels for maximum reach
- Track performance and identify repurposing opportunities

### For Video Producer
- Prioritize clear messaging and pacing over production complexity
- Test script timing by reading aloud (adjust if too fast/slow)
- Ensure audio quality is excellent (bad audio kills good video)
- Design for sound-off viewing (captions, on-screen text)
- Optimize for mobile (large text, simple visuals)

### For Copywriter
- Write for the ear, not the eye (conversational, short sentences)
- Front-load key message (grab attention in first 3-5 seconds)
- Use active voice and direct language ("You can" not "Users are able to")
- Include specific, benefit-focused CTA
- Test script at 150 words/minute pace (2.5 words/second)

---

## Approval & Version History

**Version**: 1.0.0
**Prepared By**: `[Scriptwriter, role]`
**Date**: `YYYY-MM-DD`

**Approvals**:
- [ ] Scriptwriter: `[Name, date]`
- [ ] Content Strategist: `[Name, date]`
- [ ] Video Producer: `[Name, date]`
- [ ] Product/Marketing Lead: `[Name, date]`
- [ ] Legal/Compliance (if required): `[Name, date]`

**Revision History**:

| Version | Date | Author | Changes |
|---------|------|--------|---------|
| 1.0.0 | YYYY-MM-DD | `[Name]` | Initial script |
| | | | |

---

**Related Templates**:
- STR-002: Messaging Matrix Template
- BRD-002: Voice & Tone Guide Template
- CNT-001: Blog Post Template (for video transcription)
- SOC-001: Social Media Post Template (for promotion)
- CNT-008: Newsletter Template (for email distribution)