# screenplay-camera-breakdown

> Comprehensive screenplay breakdown with detailed camera work, cinematography specs, and NANO BANANA video generation instructions

- Author: Sankhya
- Repository: budprat/sunny
- Version: 20251206151729
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/budprat/sunny
- Web: https://mule.run/skillshub/@@budprat/sunny~screenplay-camera-breakdown:20251206151729

---

---
name: screenplay-camera-breakdown
description: Comprehensive screenplay breakdown with detailed camera work, cinematography specs, and NANO BANANA video generation instructions
---

# Screenplay Camera Breakdown Skill

**Transform narrative text into professional screenplay with complete cinematography specifications**

## When to Use This Skill

Use this skill when the user needs:
- Complete screenplay breakdown from script/scene/shot/beats
- Detailed camera angles and cinematography for each shot
- Industry-standard Final Draft format output
- NANO BANANA video generation instructions
- 10-second shot breakdowns with timestamps
- Production-ready annotations and director notes

## What This Skill Delivers

✅ **Input Flexibility**: Handles script/scene/shot/beats/premise
✅ **Smart Shot Calculation**: Analyzes narrative beats, suggests optimal count
✅ **Intelligent Camera Angles**: 180+ angles via BANANA selector + creative generation
✅ **Genre Templates**: 5 genres (Film Noir, Ghibli, Cyberpunk, Romantic, Action)
✅ **Director Styles**: Fincher, Ray, Anderson, Villeneuve, Nolan
✅ **Final Draft Format**: Industry-standard .fountain with annotations
✅ **10s Timestamps**: Precise timing for every shot
✅ **Multi-shot & Jumpcuts**: Complete video generation support
✅ **NANO BANANA Instructions**: Step-by-step image editing per shot

## Skill Invocation

When user requests screenplay breakdown, camera work, or cinematography details:

```python
import sys
sys.path.insert(0, '/home/user/claudeOS/skills/screenplay-camera-breakdown')

from skill import ScreenplayBreakdownSkill

# Initialize skill
skill = ScreenplayBreakdownSkill()

# Get user input
user_input = """
[User's script/scene/shot/beats]
"""

# Collect user options
options = {
    "genre": "film_noir",  # Or auto-detect
    "director_style": "fincher",  # Optional
    "detail_level": "production_ready",  # standard | detailed | production_ready
    "title": "Screenplay Title",
    "author": "Author Name"
}

# Process
result = skill.process(
    user_input=user_input,
    options=options,
    character_images=[]  # Optional: list of image paths
)

# Output Final Draft format
print(result["final_draft"])

# Save to file
with open("screenplay_breakdown.fountain", 'w') as f:
    f.write(result["final_draft"])

# Display metadata
print(f"\n📊 Generated {result['metadata']['shot_count']} shots across {result['metadata']['scene_count']} scenes")
print(f"⏱️  Total duration: {result['metadata']['total_duration']}s")
```

## User Interaction Workflow

### Step 1: Collect Input

```
YOU: "I'll create a comprehensive screenplay breakdown for you.

Please provide your narrative input:
- Full screenplay text
- Scene description
- Single shot description
- Story beats list
- Narrative premise

Paste or describe what you have:"
```

### Step 2: Ask User Options

```
YOU: "Great! I've analyzed your input. A few customization questions:

1. **Genre/Style:** (I detected [AUTO-DETECTED], is this correct?)
   - Film Noir
   - Studio Ghibli
   - Cyberpunk
   - Romantic Drama
   - Action Thriller
   [Auto-detect] ✓

2. **Directorial Style:**
   - David Fincher (Psychological precision, controlled)
   - Satyajit Ray (Humanistic, observational)
   - Wes Anderson (Symmetrical, whimsical)
   - Denis Villeneuve (Epic scale, atmospheric)
   - Christopher Nolan (IMAX scope, temporal)
   - None (Genre-neutral)

3. **Detail Level:**
   - Standard (readable screenplay)
   - Production-Ready (full specs + NANO BANANA instructions) ← Recommended

4. **Character Images:** Do you have reference images? (Optional)

5. **Shot Duration:** 10 seconds per shot (default for video gen)
"
```

### Step 3: Process & Output

```
YOU: "Processing your screenplay...

✓ Analyzed narrative structure
✓ Identified [X] scenes, [Y] beats
✓ Calculated [Z] optimal shots
✓ Selected camera angles using BANANA intelligent system
✓ Applied [Director] style preferences
✓ Generated [Genre] cinematography specifications
✓ Created NANO BANANA editing instructions

📄 Output saved to: screenplay_breakdown.fountain

**Summary:**
- Scenes: [X]
- Total Shots: [Y]
- Duration: [Z] seconds
- Genre: [Genre]
- Director Style: [Style]

Would you like me to:
- Display specific shots in detail?
- Adjust genre or director style?
- Export to different format?
- Generate character image references?"
```

## Output Format Example

```
FADE IN:

EXT. WAREHOUSE DISTRICT - NIGHT

[SHOT 1 · 00:00:00 → 00:00:10 · Wide Tracking Lateral]
[[CAMERA: Wide · 35mm f/4.0 · Tracking · Eye-Level]]
[[LIGHTING: Low-Key Noir · Key 5500K (60%)]]
[[COLOR: #1a1a1a dominant (60%)]]

Rain streams down brick walls. Distant neon reflects in puddles.

[00:00-00:03] Detective JANE MARLOWE enters frame right, determined walk.
[00:03-00:06] Pauses briefly. Glances over shoulder.
[00:06-00:10] Continues walk, hand to coat pocket, exits frame left.

JANE MARLOWE - Woman, 40s, weathered features, dark fedora, black trench coat

[[PRODUCTION NOTES]]
[[NOTE: Wet pavement reflections critical for noir aesthetic]]
[[DIRECTOR: Fincher precision - exact rule-of-thirds]]
[[STYLE: Film noir high contrast, desaturated]]

[[NANO BANANA VIDEO GENERATION]]

[[Step 1: Generate first frame using NANO BANANA]]
[[  • Edit environment → rain-soaked alley entrance]]
[[  • Edit wardrobe → add dark fedora + trench coat]]
[[  • Edit lighting → low-key noir 5500K cool dominant]]
[[  • Camera: Wide shot, 35mm, eye-level]]
[[  Output: shot_01_frame_01.jpg]]

[[Step 2: Generate last frame using NANO BANANA]]
[[  • Edit position → left frame edge]]
[[  • Edit action → hand inside coat pocket]]
[[  • Maintain lighting + environment consistency]]
[[  Output: shot_01_frame_02.jpg]]

[[Step 3: Generate 10s video]]
[[  Method: Reference images (first + last frame)]]
[[  Motion: Smooth lateral tracking, character walks R→L]]
[[  Duration: 10s]]
[[  Output: shot_01.mp4]]

	CUT TO:
```

## Genre Templates Available

1. **Film Noir** - High contrast, desaturated, urban mystery
2. **Studio Ghibli** - Soft watercolor, warm naturalistic, whimsical
3. **Cyberpunk** - Neon-soaked, high contrast, urban dystopia
4. **Romantic Drama** - Soft focus, warm tones, intimate framing
5. **Action Thriller** - Dynamic movement, high energy, urgent pacing

## Features

### Smart Shot Count Calculation
- Analyzes narrative beats
- Applies complexity multipliers (dialogue: 1.5x, action: 2.0x, montage: 2.5x)
- Considers character count and scene type
- Practical limits for 10s shots

### BANANA Integration
- 180+ camera angles database
- Intelligent multi-dimensional scoring
- Creative angle generation when needed
- Director style preferences applied

### Production Annotations
- Camera specifications (lens, aperture, movement)
- Lighting setup (3-point, kelvin temps, intensity)
- Color palette (hex codes, coverage, dominance)
- Environment details (foreground, mid, background)
- Mood and cinematography style
- Director notes and performance cues

### Video Generation Support
- Multi-shot specifications
- Jumpcut support
- Reference frame instructions (first + last)
- NANO BANANA step-by-step editing
- 10-second duration per shot
- Timestamp tracking

## Error Handling

If BANANA angle selector not available:
- Skill uses fallback angle selection
- Basic scene type → angle mapping
- Warns user about limited intelligence

If genre not specified:
- Auto-detects from input keywords
- Defaults to Film Noir if uncertain
- User can override

If shots can't be calculated:
- Defaults to 1 shot per beat
- Minimum 1 shot, maximum 3x beats
- User can specify manually

## Performance

- **Input Parsing**: <1s
- **Scene Analysis**: <2s per scene
- **BANANA Angle Selection**: <500ms per shot (creative: <2s)
- **Full Pipeline**: ~5-10s for 6-scene screenplay

## Next Steps After Generation

1. **Review Output**: Check screenplay_breakdown.fountain
2. **Adjust if Needed**: Regenerate with different genre/director
3. **Generate Images**: Use NANO BANANA instructions
4. **Create Videos**: Follow video generation specs
5. **Edit**: Import to Final Draft or other software

## Testing

```bash
cd /home/user/claudeOS/skills/screenplay-camera-breakdown
python skill.py
```

## Documentation

- **DESIGN.md**: Complete architecture and specifications
- **README.md**: User guide and examples
- **tools/**: Individual component documentation

---

**Status**: Phase 1 MVP Complete ✅
**Version**: 1.0
**Last Updated**: 2025-01-18