video-script

Write compelling video scripts with voiceover and visual directions

SKILL.md

GitHub

Video Script Skill

Write professional video scripts with voiceover narration and visual directions.

Script Structure

Standard Video Script Format

# {Video Title}

**Duration**: {estimated length}
**Style**: {educational/news/tutorial/entertainment}
**Target Audience**: {who is this for}

---

## INTRO (0:00 - 0:15)

### VISUAL
{Description of what appears on screen}

### VOICEOVER
"{What the narrator says}"

### NOTES
{Any production notes}

---

## SECTION 1: {Title} (0:15 - 0:45)

### VISUAL
{Visual description}

### VOICEOVER
"{Narration}"

---

Script Types

1. News/Explainer Video

# {Topic} Explained

**Duration**: 60-90 seconds
**Style**: News/Educational

---

## HOOK (0:00 - 0:05)

### VISUAL
Bold text on screen: "{Attention-grabbing statement}"
Quick cuts of relevant footage

### VOICEOVER
"{One-liner that creates curiosity or states the significance}"

---

## CONTEXT (0:05 - 0:20)

### VISUAL
Background footage, screenshots, or B-roll related to topic

### VOICEOVER
"{Brief background - what viewers need to know to understand this story}"

---

## MAIN STORY (0:20 - 0:50)

### VISUAL
- Demo footage or screenshots
- Key data/stats on screen
- Expert quote overlay

### VOICEOVER
"{The meat of the story - what happened, why it matters, key details}"

---

## IMPLICATIONS (0:50 - 1:10)

### VISUAL
Conceptual visuals showing impact

### VOICEOVER
"{What this means for the viewer/industry/world}"

---

## OUTRO (1:10 - 1:20)

### VISUAL
Channel branding, subscribe button

### VOICEOVER
"{Call to action - like, subscribe, comment with thoughts}"

---

Writing Tips

Voiceover Best Practices

  1. Write for the ear: Use conversational language
  2. Short sentences: 15-20 words max per sentence
  3. Active voice: "The company launched" not "was launched by"
  4. Present tense: Creates immediacy
  5. Read aloud: Test if it sounds natural
  6. Pause points: Use "..." for natural breathing pauses

Hook Formulas

Type Example
Curiosity "What if I told you..."
Stakes "This could change everything about..."
Contrast "Everyone thought X, but actually..."
Question "Have you ever wondered why..."
Bold claim "This is the biggest {thing} since..."

Pacing Guidelines

Section % of Video Purpose
Hook 5-10% Grab attention
Context 15-20% Set up understanding
Main content 50-60% Deliver value
Implications 10-15% Make it relevant
CTA 5-10% Drive action

Word Count to Duration

Words Approx. Duration
50 15 seconds
100 30 seconds
150 45 seconds
200 60 seconds
300 90 seconds
400 2 minutes

Speaking pace: ~150 words per minute

Script Output File

Save completed scripts to: output/scripts/{topic}_script.md

Include metadata at top:

---
title: "{Title}"
duration: "{Estimated duration}"
created: "{Date}"
status: "draft|review|approved"
---