Cinematic Script Writer

Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge.

Installation

# Install via npm
npm install -g cinematic-script-writer

# Or install via OpenClaw CLI
openclaw skills install cinematic-script-writer

CLI Usage

Context Management

Create and manage story contexts with characters, era, and settings:

# Create a new story context
cinematic-script create-context --name "My Story" --era "Ancient India" --period "Ramayana Era"

# List all saved contexts
cinematic-script list-contexts

# Get a specific context
cinematic-script get-context --id \x3Ccontext-id>

# Delete a context
cinematic-script delete-context --id \x3Ccontext-id>

Story Generation

Generate story ideas and create cinematic scripts:

# Generate story ideas for a context
cinematic-script generate-ideas --context-id \x3Ccontext-id> --count 3

# Create a full cinematic script from an idea
cinematic-script create-script --context-id \x3Ccontext-id> --idea-id \x3Cidea-id>

# Generate YouTube metadata for a script
cinematic-script generate-metadata --script-id \x3Cscript-id>

Cinematography Reference

Access camera angles, lighting, and shot type databases:

# List all camera angles
cinematic-script list-angles

# List all camera movements
cinematic-script list-movements

# List all shot types
cinematic-script list-shots

# Get camera setup recommendation
cinematic-script suggest-camera --scene-type "dialogue" --mood "dramatic"

# Get lighting suggestions
cinematic-script suggest-lighting --scene-type "interior" --mood "mysterious"

# Get color grading suggestions
cinematic-script suggest-grading --genre "action"

# Search cinematography database
cinematic-script search --query "low angle lighting"

Character Consistency

Create character references and validate prompts:

# Create a character reference sheet
cinematic-script create-character-ref --character-id "char1" --name "Kutil" --visual "Purple rakshasa with golden eyes" --era "Ancient" --style "Pixar 3D"

# Create a voice profile for dialogue consistency
cinematic-script create-voice --character-id "char1" --name "Kutil" --personality "Mischievous, witty" --age "adult" --role "protagonist"

# Validate a prompt for anachronisms
cinematic-script validate-prompt --prompt "Your prompt here" --character-ids "char1,char2" --context-id \x3Ccontext-id>

Storage

Save projects to Google Drive or local storage:

# Connect to Google Drive
cinematic-script connect-drive

# Connect to local storage
cinematic-script connect-local

# Check storage connection status
cinematic-script storage-status

# Save project to storage
cinematic-script save --title "My Story" --context-id \x3Ccontext-id> --script-id \x3Cscript-id>

Storage implementation details:

• Google Drive: Uses Google OAuth2 for authentication. Credentials are stored securely in memory.
• Local Storage: Saves to the user's downloads folder as fallback.
• Library: Uses googleapis for Google Drive integration.

Export

Export scripts in various formats:

# Export as Markdown (default)
cinematic-script export --script-id \x3Cscript-id> --format markdown

# Export as JSON
cinematic-script export --script-id \x3Cscript-id> --format json

# Export as plain text
cinematic-script export --script-id \x3Cscript-id> --format text

Features

• Story Context Management: Create and manage story settings, characters, and eras
• Story Idea Generation: Generate multiple story concepts with hooks and twists
• Cinematic Script Writing: Full scripts with camera angles, lighting, and shot types
• Character Consistency: Reference sheets and voice profiles for consistent characters
• Environment Consistency: Era-appropriate style guides and anachronism detection
• YouTube Metadata: Generate titles, descriptions, and SEO tags
• Storage Integration: Save to Google Drive or local storage
• Export Options: JSON, Markdown, or plain text formats

When to Use

• Writing cinematic scripts or screenplays
• Creating stories with characters for animation/video
• Generating image/video prompts for AI tools (Midjourney, Sora, Veo, Runway)
• Getting cinematography guidance (camera angles, lighting, color grading)
• Maintaining character consistency across scenes
• Saving script projects to Google Drive

Cinematography Reference

Camera Angles

Camera Movements

Shot Types

Lighting Techniques

Color Grading

Image Prompt Format

When generating image prompts for AI tools:

[Shot type] [camera angle] of [subject doing action], [visual style] style,
[lighting technique], [composition rule], [color grading],
[era-appropriate details], [mood keywords], highly detailed, cinematic

Example:

Low-angle close-up of Kutil the purple rakshasa with mischievous golden eyes,
Pixar 3D style, dramatic underlighting with rim light, rule-of-thirds composition,
warm golden color grading, ancient Lanka palace background with ornate pillars,
playful yet mysterious mood, highly detailed, cinematic, 8k

Output Structure

When saving a project, the following files are generated:

Story Title/
├── 00_INDEX.md           # Navigation
├── 01_SCRIPT_README.md   # Human-readable script
├── 02_IMAGE_PROMPTS.md   # All AI generation prompts
├── 03_CHARACTER_REFS.md  # Character design guides
├── 04_VOICE_GUIDES.md    # Dialogue consistency guides
├── 05_YOUTUBE_META.md    # Title, description, tags
└── 99_CONTEXT_INFO.md    # Story context and background

Important Rules

1. Always maintain character consistency - include character's full visual description in every image prompt
2. Never include anachronisms - validate props, clothing, objects against the era
3. Match cinematography to emotion - use low angles for power, high angles for vulnerability
4. Include both image and video prompts - image prompts are static, video prompts describe motion
5. Production-ready output - every script should include enough detail for a team to produce it
6. Respect the tone - comedy needs comedic timing; drama needs longer holds on reactions

License

MIT

Author

Praveen Kumar