script-writer

# Script Writer

## Overview

This skill transforms Claude into a professional YouTube scriptwriter that understands your unique style and generates complete, engaging video scripts optimized for viewer retention and engagement.

## When to Use This Skill

Invoke this skill for YouTube scriptwriting tasks:
- Writing complete video scripts
- Creating hooks and introductions
- Structuring content for engagement
- Adapting scripts to different formats
- Maintaining consistent voice and style
- Generating multiple script variations

## Workflow

### Step 1: Check for Existing Preferences

```bash
python3 scripts/script_db.py is_initialized
```

If "false", proceed to Step 2. If "true", proceed to Step 3.

### Step 2: Initial Preference Collection

Collect comprehensive scriptwriting preferences:

**Script Types (can select multiple):**
- Educational/Tutorial
- Listicle/Top X
- Story/Narrative
- Review
- Vlog style
- Commentary/Opinion
- How-to
- Explainer
- Entertainment

**Tone:**
- Professional/Authoritative
- Casual/Friendly
- Energetic/Enthusiastic
- Educational/Patient
- Inspirational/Motivational
- Humorous/Entertaining
- Conversational

**Target Audience:**
- Age range (teens, 20s-30s, 35-50, 50+)
- Knowledge level (beginners, intermediate, expert)
- Demographics
- Interests
- Pain points

**Style Preferences:**
- Wording style: Simple/Direct, Descriptive/Vivid, Technical/Precise, Storytelling
- Sentence length: Short/punchy, Medium, Long/flowing
- Paragraph structure: Quick cuts, Balanced, Longer sections
- Use of rhetorical questions: Yes/No/Sometimes
- Use of statistics/data: Heavy, Moderate, Light, None

**Video Length Preference:**
- Short form (3-5 minutes, ~450-750 words)
- Medium form (7-12 minutes, ~1,050-1,800 words)
- Long form (15-30 minutes, ~2,250-4,500 words)

**Hook Style:**
- Question-based
- Bold statement
- Conflict/Problem
- Promise/Benefit
- Shock value
- Story opening

**Personality:**
- Energetic and animated
- Calm and measured
- Witty and humorous
- Serious and thoughtful
- Passionate and intense
- Relatable and down-to-earth

**Additional Preferences:**
- Use humor: Yes/No/Sparingly
- Include statistics: Always/When relevant/Rarely
- Storytelling approach: Heavy/Moderate/Light
- Call-to-action preference: Direct/Soft/Minimal
- Personal anecdotes: Frequently/Occasionally/Rarely
- Channel niche/focus

**Saving Preferences:**

```python
import sys
sys.path.append('[SKILL_DIR]/scripts')
from script_db import save_preferences

preferences = {
    "script_types": ["educational", "listicle"],
    "tone": "casual-friendly",
    "target_audience": {
        "age_range": "20s-30s",
        "knowledge_level": "beginner-intermediate",
        "interests": ["productivity", "technology"]
    },
    "style": {
        "wording": "simple-direct",
        "sentence_length": "short-punchy",
        "use_questions": True,
        "use_statistics": "moderate"
    },
    "video_length": "medium",
    "hook_style": "question-problem",
    "personality": "relatable-energetic",
    "use_humor": True,
    "storytelling_approach": "moderate",
    "call_to_action_preference": "direct",
    "channel_niche": "productivity tips"
}

save_preferences(preferences)
```

### Step 3: Generate Script for Topic

When user requests a script, gather:

**Essential Information:**
1. **Topic/Title**: What the video is about
2. **Key Points**: Main things to cover (3-5 points)
3. **Video Length**: Specific duration or use preference
4. **Special Requirements**: Anything specific to include/avoid
5. **Target Keywords**: For SEO (optional)

**Example Request:**
```
User: "Write a script about '5 Productivity Apps That Changed My Life'"

Gather:
- Video length: 10 minutes (medium form)
- Key apps to cover: 5 specific apps
- Angle: Personal experience + practical benefits
- CTA: Link to full app list in description
```

### Step 4: Structure the Script

Based on preferences and `references/script_formats.md`, create structure:

**Standard YouTube Script Structure:**

```
[HOOK - 0:00-0:10]
Opening line that stops the scroll

[INTRO - 0:10-0:45]
- Quick greeting
- What video is about
- Why viewer should watch
- What they'll learn
- Personal credibility/context

[MAIN CONTENT - 0:45-8:30]
Section 1: [Point 1]
- Introduction to point
- Explanation
- Example/Story
- Benefit/Application
- Transition

Section 2: [Point 2]
- Introduction to point
- Explanation
- Example/Story
- Benefit/Application
- Transition

[Continue for each main point]

[CONCLUSION - 8:30-9:30]
- Recap of main points
- Key takeaway
- Final thought
- Setup for CTA

[CALL TO ACTION - 9:30-10:00]
- Primary CTA (subscribe, like, comment)
- Secondary CTA (links, next video)
- Sign-off
```

### Step 5: Write Complete Script

Generate full script following structure with user's style preferences:

**Example Script Output:**

```
===================================
YOUTUBE SCRIPT
===================================

Title: 5 Productivity Apps That Changed My Life
Duration: ~10 minutes (~1,500 words)
Style: Casual-Friendly, Educational

===================================

[HOOK - 0:00-0:10]

"I used to waste 3 hours every day on useless tasks until I found these 5 apps.
And no, I'm not talking about the ones everyone already knows about."

[INTRO - 0:10-0:45]

"Hey everyone! If you're like me, you've downloaded dozens of productivity apps
only to abandon them after a week. But these 5? They've actually stuck. In fact,
they've saved me over 15 hours every single week for the past 6 months.

Today, I'm sharing the exact apps I use daily, why they work, and how you can
implement them right now. And stick around because app number 5 is so simple,
you'll wonder why you haven't been using it already.

Let's dive in."

[MAIN CONTENT - 0:45-8:30]

[Section 1: App #1 - 1:00-2:30]

"App number one is Notion – but not how you think.

I know, I know – everyone talks about Notion. But here's the thing: most people
overcomplicate it. I used to spend hours build