ai-video-creator/.agent/skills/storyboard-generator/README.md

# 🎬 Storyboard Generator for Google Antigravity

## 📖 Overview

This Agent Skill transforms complete video scripts into professional 3x3 grid storyboard key frame images using Google Nano Banana Pro's advanced capabilities:
- Character consistency maintenance
- Professional-grade image quality
- Multi-language text rendering
- Real-world knowledge integration

## 🚀 Usage

### Command Format
```bash
/storyboard-generator [script-document-path-or-content]
```

### Usage Examples

#### Based on Generated Script Document
```bash
/storyboard-generator video-script-失去遗忘能力-20260204.md
```

#### Direct Script Content Input
```bash
/storyboard-generator "Video Title: What if humans lost the ability to forget
Opening Hook (0-7s): A person surrounded by memory fragments...
Problem Introduction (7-25s): Joy vs pain memory comparison..."
```

#### Natural Language Trigger
```bash
"Generate a 3x3 storyboard grid based on my script document"
"Create professional key frame preview for this video"
```

## 🎯 Google Nano Banana Pro Advantages

### 🎭 Character Consistency
- **Same Person**: Maintain appearance across different scenes
- **Expression Changes**: Different emotional expressions for same character
- **IP Imagery**: Visual unity for brand or series content

### 🌍 Real-world Knowledge
- **Scientific Accuracy**: Accurate visual representation of medical, physics concepts
- **Scene Realism**: Environment design combining real-world data
- **Cultural Adaptation**: Accurate representation of different regions and cultures

### 🔤 Multi-language Text Rendering
- **Chinese & English Subtitles**: High-quality text rendering
- **Professional Terms**: Accurate display of scientific terms and proper nouns
- **Title Design**: Professional-grade titles and graphic text

## 📊 Output Components

### 1. 3x3 Storyboard Grid
```
Standard 3x3 format including:
┌─────────────┬─────────────┬─────────────┐
│  Frame 1    │   Frame 2   │   Frame 3   │
│ Opening Hook│ Problem Intro│Crisis Display│
│   (0-7s)    │   (7-25s)   │  (25-65s)   │
├─────────────┼─────────────┼─────────────┤
│  Frame 4    │   Frame 5   │   Frame 6   │
│ Science 1   │  Science 2  │ Deep Impact │
│ (65-100s)   │ (100-140s)  │ (140-180s)  │
├─────────────┼─────────────┼─────────────┤
│  Frame 7    │   Frame 8   │   Frame 9   │
│  Solution   │  Summary    │Call to Action│
│ (180-200s)  │ (200-210s)  │   Ending    │
└─────────────┴─────────────┴─────────────┘
```

### 2. Professional Production Reference
- **Key Frame Description Table**: Detailed production requirements for each frame
- **Visual Style Guidelines**: Color, composition, lighting standards
- **Technical Parameters**: Shot types, angles, special effects requirements

### 3. Nano Banana Pro Prompts
- **Complete Generation Instructions**: Ready-to-use professional prompts
- **Per-frame Optimization Suggestions**: Optimization plans for each key frame
- **Consistency Parameters**: Technical settings ensuring visual coherence

## 💡 Best Practices

### Script Preparation
1. **Clear Time Nodes**: Each scene has clear time markers
2. **Detailed Visual Descriptions**: Complete elements for visuals, colors, emotions
3. **Clear Transition Logic**: Clear connection relationships between scenes

### Storyboard Design Principles
1. **Visual Rhythm**: Changes in shot types and composition
2. **Emotional Delivery**: Each frame accurately conveys corresponding emotion
3. **Information Hierarchy**: Visual prominence of important information

### Nano Banana Pro Usage Tips
1. **Consistent Character Description**: Maintain key terms after first description
2. **Fixed Style Parameters**: Use consistent style descriptors
3. **Quality Parameters**: Always include professional quality parameters

## 🔧 Advanced Usage

### Complex Script Handling
```bash
# Scripts with more than 9 key frames
"This script has 15 key scenes, please generate 2 storyboard grids"

# Specific section emphasis
"Focus on creating detailed storyboards for the science explanation section (65-140s)"
```

### Style Customization
```bash
# Specify visual style
"Regenerate storyboard using cyberpunk aesthetic"

# Character consistency requirements
"Ensure the protagonist maintains same appearance and clothing in all frames"
```

### Platform Adaptation
```bash
# Different size requirements
"Generate portrait version of the storyboard"
"Create square 3x3 grid suitable for Instagram"
```

## 📱 Output Format Options

### Standard 3x3 Grid
- **Size**: 1080x1080 (social media)
- **Usage**: Preview, team communication, investor presentation

### Professional Production Version
- **Size**: 3840x2160 (4K)
- **Usage**: Formal production, print output

### Extended Versions
- **Multiple Images**: Complete storyboard for complex scripts
- **Individual Frame Output**: HD version of each key frame

## 🔄 Integration with Other Skills

### Complete Workflow
```
1. viral-topic-generator (Topic Analysis)
    ↓
2. video-script-writer (Complete Script)
    ↓
3. storyboard-generator (Storyboard Preview) ← You are here
    ↓
4. Production Execution (Film/Create based on storyboard)
```

### Iterative Optimization
```
Storyboard Generation → Team Review → Modify Adjustments → Regenerate → Final Version
```

## 📝 Quality Checklist

### Visual Quality
- ✅ Each frame clear with professional composition
- ✅ Unified and coordinated color style
- ✅ Consistent character appearance
- ✅ Clear and readable text and logos

### Narrative Continuity
- ✅ Key frames accurately reflect script content
- ✅ Visual rhythm matches emotional changes
- ✅ Clear scene transition logic
- ✅ Accurate time progression expression

### Production Feasibility
- ✅ Composition suitable for actual filming/production
- ✅ Special effects requirements within budget
- ✅ Reasonable props and scene requirements
- ✅ Technical difficulty matches team capabilities

## 📱 Platform Compatibility

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

## 📝 FAQ

**Q: Character consistency not good enough?**
A: Describe character features in detail in first frame, repeat key feature words in subsequent frames

**Q: Text in grid not clear?**
A: Utilize Nano Banana Pro's multi-language rendering capability, specify text requirements clearly in prompts

**Q: How to handle complex scientific concept visualization?**
A: Use real-world knowledge function, provide specific scientific terms and reference requirements

## 🌟 Expected Success Case

Based on your "losing forgetting ability" script, the generated storyboard will include:
- **Opening**: Strong visual impact of floating memory fragments
- **Science**: Accurate medical representation of brain neural networks
- **Emotion**: Sharp contrast between pain and hope
- **Elevation**: Philosophical imagery of time healing concept

**Expected Result**: Professional-grade storyboard preview that can directly guide production teams in video creation, significantly improving production efficiency and final quality.

## 🔗 Google Nano Banana Pro Information

Learn more about the advanced AI image generation technology powering this skill:
- [Nano Banana Pro: Gemini 3 Pro Image model from Google DeepMind](https://blog.google/technology/ai/nano-banana-pro/)
- [Nano Banana Pro - Gemini AI image generator & photo editor](https://gemini.google/overview/image-generation/)
- [Nano Banana image generation | Gemini API | Google AI for Developers](https://ai.google.dev/gemini-api/docs/image-generation)

---

Ready to transform your script into professional storyboard grids? Let Nano Banana Pro provide the best visual preview for your video production!