ai-video-creator/.agent/skills/video-script-writer/README.md

# 🎬 Video Script Writer for Google Antigravity

## 📖 Overview

This Agent Skill transforms video topics and outlines into comprehensive production scripts, complete with detailed narration, visual descriptions, and AI image generation prompts for seamless content creation workflow.

## 🚀 Usage

### Command Format
```bash
/video-script-writer [topic-content]
```

### Usage Examples

#### Complete Topic Input
```bash
/video-script-writer "Topic: What if humans lost the ability to forget?
Target Audience: Neuroscience enthusiasts, students, emotional content viewers
Duration: 3-4 minutes
Hook: You clearly remember the trajectory of breadcrumbs falling 3 years ago..."
```

#### Simple Title Input
```bash
/video-script-writer "What would happen if humans couldn't forget?"
```

#### Natural Language Trigger
```bash
"Turn this topic into a complete video script with AI image prompts: [topic content]"
```

## 📋 Input Format Recommendations

### Complete Topic Input (Recommended)
```
Topic Title: [Title]
Target Audience: [Audience description]
Duration: [Duration]
Content Outline:
- Hook: [Opening design]
- Problem Introduction: [Problem description]
- Core Content: [Main knowledge points]
- Climax: [Turning point]
- Summary: [Ending design]
Viral Elements: [Special elements]
```

### Simplified Input
```
[Video Title] - [Target Audience] - [Core Concept]
```

## 🎯 Output Components

### 1. Complete Script Structure
- **Segmented Timing**: Each segment marked with time intervals
- **Narration Copy**: Including stress and pause markings
- **Visual Descriptions**: Detailed visual guidance
- **Transition Design**: Scene-to-scene transition methods

### 2. AI Image Generation Prompts
Each key scene includes:
```
[Scene Description], [Style: flat design/realistic/cartoon],
[Composition: centered/rule of thirds], [Color palette: warm/cool/monochrome],
[Mood: energetic/calm/mysterious], [Quality: 8k, detailed, cinematic]
```

### 3. Production Guidance
- Rhythm control points
- Sound effects and music suggestions
- Subtitle and graphic design requirements
- Interaction guidance strategies

## 💡 Best Practices

### Topic Preparation
1. **Define Target Audience**: The more specific, the better
2. **Identify Core Knowledge**: 1-3 main concepts
3. **Design Emotional Curve**: Plan audience emotional journey

### Usage Tips
1. **Broad to Specific**: Generate basic script first, then refine specific parts
2. **Iterative Optimization**: Continuously adjust based on feedback
3. **Platform Adaptation**: Adjust for different platform requirements

### Subsequent Applications
1. **Direct Production**: Use generated AI prompts to create visual assets
2. **A/B Testing**: Generate multiple opening versions for testing
3. **Series Planning**: Expand one script into series content

## 🔧 Advanced Usage

### Specific Scene Optimization
```bash
# Request specific part optimization
"Please elaborate on the script content from minute 2 to minute 3"

# Style adjustment
"Adjust this script to a more humorous tone"

# Platform adaptation
"Adapt this 3-minute script to a 60-second TikTok version"
```

### Visual Style Customization
```bash
# Specify drawing style
"Adjust all AI image prompts to cyberpunk style"

# Character design
"The script needs a fixed IP character, please design corresponding prompts"
```

## 📊 Quality Checklist

### Script Completeness
- ✅ Every time segment has corresponding content
- ✅ Narration copy flows naturally
- ✅ Visuals coordinate with narration
- ✅ Transitions are smooth and natural

### Visual Design
- ✅ AI prompts are detailed and specific
- ✅ Visual style is unified and coherent
- ✅ Key scenes have sufficient visual impact
- ✅ Color and composition have guiding significance

### Production Feasibility
- ✅ Production difficulty meets expectations
- ✅ Material requirements are clear and reasonable
- ✅ Duration allocation is scientific
- ✅ Interaction design is effective

## 🔄 Integration with Other Skills

### Recommended Workflow
1. **Topic Planning**: Use `viral-topic-generator` to analyze reference videos and generate topics
2. **Script Creation**: Use `video-script-writer` to expand topics into complete scripts
3. **Asset Creation**: Use generated AI prompts to create visual materials
4. **Post-Production**: Follow script guidance for video editing

### Iterative Optimization Loop
```
Topic → Script → Test Feedback → Optimize Script → Remake
```

## 📱 Platform Compatibility

Works seamlessly across:
- ✅ Google Antigravity
- ✅ Claude Code
- ✅ Cursor
- ✅ Other Agent Skills-compatible tools

## 📝 FAQ

**Q: Script too long/short?**
A: Request "compress script to X minutes" or "elaborate XX section"

**Q: AI prompts not accurate enough?**
A: Ask to "optimize XX scene's image prompt for more specificity"

**Q: How to adapt for different platforms?**
A: Specify target platform, e.g., "adapt for Xiaohongshu short video format"

## 🎬 Example Usage with Your Topic

Based on your provided topic about losing the ability to forget:

```bash
/video-script-writer "选题2：【故障】如果全人类突然失去了'遗忘'的能力
目标受众：脑科学爱好者、考研党、情感类受众
预估时长：3-4分钟
Hook：你清楚地记得3年前的今天早上吃的面包屑掉落的轨迹
核心内容：科普'突触修剪'与遗忘机制对大脑的重要性"
```

---

Ready to transform your viral topics into production-ready scripts? Input your topic content and begin your content creation journey!