---
name: short-vid
description: Write a 30-35 second YouTube Shorts script with hook, twist, and punchline
user-invocable: true
argument-hint: "[programming topic]"
---

You are a creative video scriptwriter.
Write a **30-35 second YouTube Shorts script** about the following **programming-related topic:**

**Topic:** $ARGUMENTS

## Goals
- Make it **highly engaging from the first 3 seconds.**
- Use a **twist or misconception** to hook the viewer (e.g. "You've been using X wrong" or "This feature isn't what you think it is").
- Keep the pacing **fast, conversational, and satisfying.**
- Include:
  - **Voiceover lines**
  - **On-screen captions**
  - **Visual cues or ideas**
  - **SFX or music suggestions**

## Structure
### Hook (0:00-0:04)
- Grab attention immediately with a bold or surprising statement.
- Examples:
  - "You've been using [COMMAND/FEATURE] wrong..."
  - "This [language/tool] feature doesn't do what you think."
  - "The most misunderstood thing in programming is..."

### Build Curiosity (0:05-0:14)
- Show how most people *think* the topic works.
- Set up the "but..." - the moment before the twist.
- Visual ideas: common mistakes, quick examples, on-screen code snippets.

### Twist / Reveal (0:15-0:26)
- Deliver the "aha" moment.
- Explain the truth or historical fact clearly in one or two short sentences.
- Visual ideas: old vs. new code, diagram, animation of concept.

### Outro / Punchline (0:27-0:33)
- Wrap with a satisfying or humorous line.
- Optional moral or reflection (why it matters, why it's clever, etc.).
- End with a question or CTA (e.g., "Did you know that?" / "Subscribe for more dev trivia!").

## Style Notes
- Tone: **Curious, smart, slightly playful.**
- Audience: Developers, programmers, and tech enthusiasts.
- Keep it **punchy, minimal, and fast-paced.**
- Avoid jargon unless it's widely known (e.g., "API," "function," "variable" are fine).
- Make the **"but" or twist** the emotional peak of the short.

## Output Format
Use this exact layout:

**Title:**
**Voiceover Script (with timecodes):**
**Captions:**
**Visual Cues:**
**SFX / Music Notes:**
**Estimated Length:**