youtube-scriptwriting

Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.

8 stars

Best use case

youtube-scriptwriting is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.

Teams using youtube-scriptwriting should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/youtube-scriptwriting/SKILL.md --create-dirs "https://raw.githubusercontent.com/cdeistopened/skill-stack/main/.claude/skills/youtube-scriptwriting/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/youtube-scriptwriting/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How youtube-scriptwriting Compares

Feature / Agentyoutube-scriptwritingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# YouTube Script Writing

Transform disorganized ideas into retention-optimized scripts through a checkpoint-based workflow.

## Core Psychology

All great scripts operate on one principle: **Reality must beat expectations.**

- Viewer expectations = what they think will happen based on title/thumbnail
- Reality = what you actually deliver in the video
- When reality > expectations → satisfaction, engagement, shares
- When reality < expectations → disappointment, drop-off, bounce

Every decision in scriptwriting serves this gap.

## The Workflow

Work through these checkpoints in order. Each builds on the previous.

### Checkpoint 1: Define the Foundation

Before writing anything:

1. **Target audience**: Who specifically is watching? What do they already know?
2. **Desired emotion**: Pick ONE primary emotion to transfer:
   - Awe/inspiration
   - Amusement/humor
   - Excitement/joy
   - Anger/outrage
   - Surprise/shock/curiosity
   - Sadness/empathy
3. **Core promise**: One sentence describing what viewer gets from watching

### Checkpoint 2: Research & Mine for Shock

Find the facts that will beat expectations. See [references/research.md](references/research.md).

**Shock Score Method**: Rate each fact 1-100 based on "How many viewers would NOT know this?"
- 80+ = Gold (most viewers surprised)
- 50-79 = Good supporting points
- Below 50 = Skip unless essential context

Collect 5-10 high-shock facts before proceeding.

### Checkpoint 3: Write the Hook

The hook confirms the click and opens a curiosity loop. See [references/hooks.md](references/hooks.md) for the 9 proven formats.

**Quick Formula** (works for any niche):
- **Target**: Who is this for?
- **Transformation**: What will they gain?
- **Stakes**: What happens if they don't watch?

**Hook Commandments** (verify all 4):
1. Alignment: Visual, spoken, and text hooks match
2. Speed: Value promised in first 3 seconds
3. Clarity: Topic is unmistakable
4. Curiosity: Opens a question they must answer

### Checkpoint 4: Choose Story Structure & Outline

Pick ONE structure that fits your content. See [references/structures.md](references/structures.md) for all 7 formats.

**Most Common Structures**:
- **Tutorial**: Step-by-step process → Hook → Steps → Outro
- **Listicle**: Ordered items → Hook → List → Outro
- **Problem-Solver**: Pain → Solution → Hook → Problem → Solution → Outro
- **Case Study**: How X achieved Y → Hook → Framework → Outro

Create a bullet outline BEFORE writing. Sequence your shock facts logically.

### Checkpoint 5: Write the Body

For each section, use the **Value Loop**:
1. **Context**: What is it? (Simple, clear)
2. **Application**: How to use it? (Examples)
3. **Framing**: Why does it matter? (Connect to bigger picture)

**Retention Techniques** (see [references/retention.md](references/retention.md)):
- **Rehooks**: Every 30-60 seconds, reagitate the promise ("But here's where it gets interesting...")
- **Setups & Payoffs**: Tease information, delay reveal, then deliver
- **Second-best first**: Put your second-best point first, best point second (creates ascending pattern)

### Checkpoint 6: Edit for Quality

Run three audits on your draft. See [references/editing.md](references/editing.md).

**1. Story Flow Audit**
- Read each line: Is this necessary or a tangent?
- Delete anything that breaks the through-line
- Test: Can viewer follow beginning to end without getting lost?

**2. Comprehension Audit**
- Target 6th grade vocabulary
- Shorter sentences (staccato, not run-on)
- Active voice ("The dog jumped" not "The jumping was done by the dog")
- Restate complex ideas twice, second time simpler

**3. Speed-to-Value Audit**
- Is value signaled in first 3 seconds?
- Rehooks every 30-60 seconds?
- Outro summarizes or extends value?

### Checkpoint 7: Outro & CTA

**Binge Loop Formula** (last 15-30 seconds):
1. Link back to video content naturally
2. Introduce a NEW problem/question
3. Promise to solve it in another video or resource

## Quick Reference: Script Template

```
HOOK (0-15 seconds)
- Confirm the click
- Open curiosity loop
- Establish credibility (optional)

BODY SECTION 1 (Rehook → Content → Payoff)
[Second-best point]

BODY SECTION 2 (Rehook → Content → Payoff)
[Best point]

BODY SECTION 3+ (Rehook → Content → Payoff)
[Remaining points in descending order]

OUTRO (Last 15-30 seconds)
- Summarize value delivered
- Binge loop to next video/resource
```

## When to Use Each Reference

- **Starting from scratch with no topic?** → [references/research.md](references/research.md)
- **Stuck on how to start the video?** → [references/hooks.md](references/hooks.md)
- **Don't know how to organize points?** → [references/structures.md](references/structures.md)
- **Retention dropping mid-video?** → [references/retention.md](references/retention.md)
- **Script feels clunky or confusing?** → [references/editing.md](references/editing.md)

Related Skills

youtube-ingest

8
from cdeistopened/skill-stack

Transcribe YouTube videos and playlists using Gemini Flash

youtube-title-creator

8
from cdeistopened/skill-stack

Generate high-CTR YouTube titles and thumbnails using framework fitting method. Match content to 119 proven formulas from Creator Hooks, apply psychological principles, test variations.

youtube-downloader

8
from cdeistopened/skill-stack

Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.

youtube-clip-extractor

8
from cdeistopened/skill-stack

Download YouTube videos, identify compelling clips from transcripts, cut clips with ffmpeg, and generate platform-optimized on-screen text and captions. Complete workflow from URL to publishable clips.

x-viral-template-miner

8
from cdeistopened/skill-stack

When the user wants to find proven-to-travel post templates in their niche and adapt them to their own product. Also use when the user mentions "what's going viral in my space", "what are competitors posting", "copy a viral post", "trending on X", "post ideas", "template mining", or "what to post this week". This is trend hunting, not plagiarism — the output is a template the user fills with their own assets.

x-linkedin-content-relay

8
from cdeistopened/skill-stack

When the user has X (Twitter) content that performed well and wants to relay it to LinkedIn 1-2 weeks later with reframing. Also use when the user mentions "repost to LinkedIn", "LinkedIn version of my tweet", "X to LinkedIn", "delayed repost", "LinkedIn for non-tech audience", or "LinkedIn relay". Also use when the user's ICP is non-tech and X is secondary — LinkedIn is the primary channel and this skill produces the content.

x-launch-video-structure

8
from cdeistopened/skill-stack

When the user is planning, scripting, or editing a product launch video for X (Twitter) and needs the structure. Also use when the user mentions "launch video", "demo video", "product launch on X", "60 second demo", "how to structure a launch", or "my launch video isn't working". Produces a beat-by-beat timing sheet, not copy.

x-account-warmup

8
from cdeistopened/skill-stack

When a user wants to grow an X (Twitter) account from zero before a product launch, or asks how to get first followers, warm up the algorithm, hit ~500-1,000 followers, or prepare an account to make a launch video land. Also use when the user mentions "new X account", "warm up my Twitter", "first 1000 followers", "building in public strategy", "X growth", or "engagement before launch".

skill-stack-thumbnails

8
from cdeistopened/skill-stack

Generate blog post thumbnails for Skill Stack using the brand aesthetic. Follows an iterative workflow - brainstorm concepts, get approval, generate with Gemini API.

web-scrape

8
from cdeistopened/skill-stack

Scrape web pages to clean markdown with optional AI summaries

voice-tyler-cowen

8
from cdeistopened/skill-stack

Write in Tyler Cowen's style - matter-of-fact, understated, treats enormous ideas as obvious observations. Read the passages. Absorb the flatness. Channel the HOW, not the content.

voice-trung-phan

8
from cdeistopened/skill-stack

Generate tweets and threads in the style of Trung Phan. Not just voice — captures his humor mechanics, format taxonomy, topic selection filter, and structural patterns. Use for trend-reactive tweets, meme commentary, and business/culture threads.