/script-writer

name: script-writer
description: This skill should be used whenever users need YouTube video scripts written. On first use, collects comprehensive preferences including script type, tone, target audience, style, video length, hook style, use of humor, personality, and storytelling approach. Generates complete, production-ready YouTube scripts tailored to user's specifications for any topic. Maintains database of preferences and past scripts for consistent style.

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

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:**

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