Video Script Writer

---
name: video-script-writer
description: |
  Write video scripts for YouTube, courses, and presentations. Trigger when the
  user needs a script, voiceover text, or video outline. Phrases: "write a script",
  "video script", "youtube script", "voiceover", "course script".
allowed-tools:
  - Read
  - Write
  - Edit
---

# Video Script Writer

Write structured video scripts with timing cues, visual directions, and
voiceover text. Optimized for YouTube, online courses, and presentations.

## Script format

```markdown
## [Section Title] (MM:SS - MM:SS)

[VISUAL: Description of what is on screen]

Voiceover text goes here. Keep sentences short. Pause between concepts.

[SCREEN: code demo / terminal / slides]

Continue voiceover...
```

## Structure

1. **Hook** (0:00 - 0:30) - Problem statement or compelling question
2. **Context** (0:30 - 1:30) - Why this matters, who it is for
3. **Main content** (1:30 - X:XX) - Teaching/demo sections
4. **Recap** (last 30s) - Key takeaways, call to action

## Style rules

- Write for speaking, not reading (contractions, short sentences)
- One idea per sentence, one topic per section
- Include timing estimates for each section
- Mark visual directions in [BRACKETS]
- Keep total length appropriate: tutorial 8-15 min, explainer 5-8 min

## Example usage

- "Write a 10-minute tutorial script on Next.js server components"
- "Create a voiceover script for this product demo"
- "Outline a course module on React hooks"

## Requirements

- Topic outline or research notes as input