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.
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/youtube-scriptwriting/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How youtube-scriptwriting Compares
| Feature / Agent | youtube-scriptwriting | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
Transcribe YouTube videos and playlists using Gemini Flash
youtube-title-creator
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
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
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
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
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
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
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
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
Scrape web pages to clean markdown with optional AI summaries
voice-tyler-cowen
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
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.