Generated note: shared plugin assets for this package live at the plugin root. Common local references were rewritten when they appeared in backticks or markdown links.
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 <context-id>
# Delete a context
cinematic-script delete-context --id <context-id>
Story Generation
Generate story ideas and create cinematic scripts:
# Generate story ideas for a context
cinematic-script generate-ideas --context-id <context-id> --count 3
# Create a full cinematic script from an idea
cinematic-script create-script --context-id <context-id> --idea-id <idea-id>
# Generate YouTube metadata for a script
cinematic-script generate-metadata --script-id <script-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 <context-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 <context-id> --script-id <script-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 <script-id> --format markdown
# Export as JSON
cinematic-script export --script-id <script-id> --format json
# Export as plain text
cinematic-script export --script-id <script-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
| Angle |
Emotional Impact |
Best For |
| Eye-level |
Connection, equality, neutrality |
Dialogue, emotional moments |
| Low-angle |
Power, dominance, heroism |
Villain reveals, hero moments |
| High-angle |
Vulnerability, weakness, overview |
Defeat, establishing scale |
| Bird-eye |
Insignificance, detachment, patterns |
Epic scale, isolation |
| Worm-eye |
Awe, grandeur, overwhelming presence |
Monuments, giants, deities |
| Dutch angle |
Unease, disorientation, tension |
Chaos, dreams, horror |
| Overhead |
Omniscience, surveillance |
Table scenes, fight choreography |
| Shoulder-level |
Intimate, casual, documentary feel |
Walking conversations |
| Hip-level |
Cowboy feel, casual tension |
Westerns, standoffs |
| Knee-level |
Childlike perspective, grounding |
Children's stories, humility |
Camera Movements
| Movement |
Effect |
Use For |
| Static |
Stability, observation |
Contemplation, portraits |
| Pan |
Revealing space |
Following action horizontally |
| Tilt |
Revealing height |
Following vertical action |
| Dolly |
Immersion, intimacy |
Moving toward/away from subject |
| Truck |
Following action |
Side-to-side parallel movement |
| Crane |
Epic scale, drama |
Sweeping reveals, transitions |
| Handheld |
Urgency, realism |
Documentary, action, chaos |
| Steadicam |
Smooth floating |
Following through space, dreams |
| Zoom |
Sudden focus, surprise |
Dramatic emphasis, comedy |
| Rack-focus |
Revealing connections |
Shifting attention between subjects |
Shot Types
| Shot |
Framing |
Emotional Impact |
| Establishing |
Wide location |
Sets scene, geography, time |
| Wide/Full |
Subject + surroundings |
Context, environment, scale |
| Medium |
Waist up |
Dialogue, body language |
| Close-up |
Head/shoulders |
Emotion, reaction, intimacy |
| Extreme close-up |
Detail only (eyes, hands) |
Intense emotion, symbolism |
| Over-shoulder |
Past one subject to another |
Conversation, perspective |
| POV |
Character's view |
Immersion, subjectivity |
| Insert |
Object detail |
Plot info, symbolism |
| Two-shot |
Two subjects together |
Relationship, tension |
Lighting Techniques
| Technique |
Mood |
Best For |
| Three-point |
Professional, balanced |
Dialogue, interviews |
| High-key |
Happy, optimistic, bright |
Comedy, commercials |
| Low-key |
Dramatic, mysterious |
Drama, horror, noir |
| Golden-hour |
Romantic, nostalgic, magical |
Romance, emotional moments |
| Blue-hour |
Melancholic, mysterious |
Urban, cityscapes |
| Chiaroscuro |
Dramatic contrast |
Art films, period pieces |
| Rim/backlight |
Separation, ethereal |
Silhouettes, divine presence |
| Practical |
Realistic, natural |
Candles, fires, lamps |
| God-rays |
Divine, revelation |
Spiritual moments, forests |
| Neon |
Urban, futuristic |
Cyberpunk, nightlife |
Color Grading
| Style |
Look |
Genre |
| Teal-orange |
Blockbuster cinematic |
Action, sci-fi |
| Noir |
High-contrast desaturated |
Crime, mystery |
| Vintage/sepia |
Warm, nostalgic |
Period pieces, memory |
| Pastel |
Soft, dreamy |
Romance, coming-of-age |
| Bleach bypass |
Desaturated, gritty |
War, thriller |
| Cross-process |
Surreal colors |
Music videos, dreams |
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
- Always maintain character consistency - include character's full visual description in every image prompt
- Never include anachronisms - validate props, clothing, objects against the era
- Match cinematography to emotion - use low angles for power, high angles for vulnerability
- Include both image and video prompts - image prompts are static, video prompts describe motion
- Production-ready output - every script should include enough detail for a team to produce it
- Respect the tone - comedy needs comedic timing; drama needs longer holds on reactions
License
MIT
Author
Praveen Kumar
1---2name: cinematic-script-writer-23description: "Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge. Use when the user wants to write a cinematic script, create story contexts with characters, generate image prompts for AI video tools (Midjourney, Sora, Veo), or needs cinematography guidance (camera angles, lighting, color grading). Also use for character consistency sheets, voice profiles, anachronism detection, and saving scripts to Google Drive."4metadata:5 source: https://skillmd.com/skills/dvcrn/cinematic-script-writer-26---78> Generated note: shared plugin assets for this package live at the plugin root. Common local references were rewritten when they appeared in backticks or markdown links.910# Cinematic Script Writer1112Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge.1314## Installation1516```bash17# Install via npm18npm install -g cinematic-script-writer1920# Or install via OpenClaw CLI21openclaw skills install cinematic-script-writer22```2324## CLI Usage2526### Context Management2728Create and manage story contexts with characters, era, and settings:2930```bash31# Create a new story context32cinematic-script create-context --name "My Story" --era "Ancient India" --period "Ramayana Era"3334# List all saved contexts35cinematic-script list-contexts3637# Get a specific context38cinematic-script get-context --id <context-id>3940# Delete a context41cinematic-script delete-context --id <context-id>42```4344### Story Generation4546Generate story ideas and create cinematic scripts:4748```bash49# Generate story ideas for a context50cinematic-script generate-ideas --context-id <context-id> --count 35152# Create a full cinematic script from an idea53cinematic-script create-script --context-id <context-id> --idea-id <idea-id>5455# Generate YouTube metadata for a script56cinematic-script generate-metadata --script-id <script-id>57```5859### Cinematography Reference6061Access camera angles, lighting, and shot type databases:6263```bash64# List all camera angles65cinematic-script list-angles6667# List all camera movements68cinematic-script list-movements6970# List all shot types71cinematic-script list-shots7273# Get camera setup recommendation74cinematic-script suggest-camera --scene-type "dialogue" --mood "dramatic"7576# Get lighting suggestions77cinematic-script suggest-lighting --scene-type "interior" --mood "mysterious"7879# Get color grading suggestions80cinematic-script suggest-grading --genre "action"8182# Search cinematography database83cinematic-script search --query "low angle lighting"84```8586### Character Consistency8788Create character references and validate prompts:8990```bash91# Create a character reference sheet92cinematic-script create-character-ref --character-id "char1" --name "Kutil" --visual "Purple rakshasa with golden eyes" --era "Ancient" --style "Pixar 3D"9394# Create a voice profile for dialogue consistency95cinematic-script create-voice --character-id "char1" --name "Kutil" --personality "Mischievous, witty" --age "adult" --role "protagonist"9697# Validate a prompt for anachronisms98cinematic-script validate-prompt --prompt "Your prompt here" --character-ids "char1,char2" --context-id <context-id>99```100101### Storage102103Save projects to Google Drive or local storage:104105```bash106# Connect to Google Drive107cinematic-script connect-drive108109# Connect to local storage110cinematic-script connect-local111112# Check storage connection status113cinematic-script storage-status114115# Save project to storage116cinematic-script save --title "My Story" --context-id <context-id> --script-id <script-id>117```118119Storage implementation details:120- **Google Drive**: Uses Google OAuth2 for authentication. Credentials are stored securely in memory.121- **Local Storage**: Saves to the user's downloads folder as fallback.122- **Library**: Uses `googleapis` for Google Drive integration.123124### Export125126Export scripts in various formats:127128```bash129# Export as Markdown (default)130cinematic-script export --script-id <script-id> --format markdown131132# Export as JSON133cinematic-script export --script-id <script-id> --format json134135# Export as plain text136cinematic-script export --script-id <script-id> --format text137```138139## Features140141- **Story Context Management**: Create and manage story settings, characters, and eras142- **Story Idea Generation**: Generate multiple story concepts with hooks and twists143- **Cinematic Script Writing**: Full scripts with camera angles, lighting, and shot types144- **Character Consistency**: Reference sheets and voice profiles for consistent characters145- **Environment Consistency**: Era-appropriate style guides and anachronism detection146- **YouTube Metadata**: Generate titles, descriptions, and SEO tags147- **Storage Integration**: Save to Google Drive or local storage148- **Export Options**: JSON, Markdown, or plain text formats149150## When to Use151152- Writing cinematic scripts or screenplays153- Creating stories with characters for animation/video154- Generating image/video prompts for AI tools (Midjourney, Sora, Veo, Runway)155- Getting cinematography guidance (camera angles, lighting, color grading)156- Maintaining character consistency across scenes157- Saving script projects to Google Drive158159## Cinematography Reference160161### Camera Angles162163| Angle | Emotional Impact | Best For |164|-------|-----------------|----------|165| Eye-level | Connection, equality, neutrality | Dialogue, emotional moments |166| Low-angle | Power, dominance, heroism | Villain reveals, hero moments |167| High-angle | Vulnerability, weakness, overview | Defeat, establishing scale |168| Bird-eye | Insignificance, detachment, patterns | Epic scale, isolation |169| Worm-eye | Awe, grandeur, overwhelming presence | Monuments, giants, deities |170| Dutch angle | Unease, disorientation, tension | Chaos, dreams, horror |171| Overhead | Omniscience, surveillance | Table scenes, fight choreography |172| Shoulder-level | Intimate, casual, documentary feel | Walking conversations |173| Hip-level | Cowboy feel, casual tension | Westerns, standoffs |174| Knee-level | Childlike perspective, grounding | Children's stories, humility |175176### Camera Movements177178| Movement | Effect | Use For |179|----------|--------|---------|180| Static | Stability, observation | Contemplation, portraits |181| Pan | Revealing space | Following action horizontally |182| Tilt | Revealing height | Following vertical action |183| Dolly | Immersion, intimacy | Moving toward/away from subject |184| Truck | Following action | Side-to-side parallel movement |185| Crane | Epic scale, drama | Sweeping reveals, transitions |186| Handheld | Urgency, realism | Documentary, action, chaos |187| Steadicam | Smooth floating | Following through space, dreams |188| Zoom | Sudden focus, surprise | Dramatic emphasis, comedy |189| Rack-focus | Revealing connections | Shifting attention between subjects |190191### Shot Types192193| Shot | Framing | Emotional Impact |194|------|---------|-----------------|195| Establishing | Wide location | Sets scene, geography, time |196| Wide/Full | Subject + surroundings | Context, environment, scale |197| Medium | Waist up | Dialogue, body language |198| Close-up | Head/shoulders | Emotion, reaction, intimacy |199| Extreme close-up | Detail only (eyes, hands) | Intense emotion, symbolism |200| Over-shoulder | Past one subject to another | Conversation, perspective |201| POV | Character's view | Immersion, subjectivity |202| Insert | Object detail | Plot info, symbolism |203| Two-shot | Two subjects together | Relationship, tension |204205### Lighting Techniques206207| Technique | Mood | Best For |208|-----------|------|----------|209| Three-point | Professional, balanced | Dialogue, interviews |210| High-key | Happy, optimistic, bright | Comedy, commercials |211| Low-key | Dramatic, mysterious | Drama, horror, noir |212| Golden-hour | Romantic, nostalgic, magical | Romance, emotional moments |213| Blue-hour | Melancholic, mysterious | Urban, cityscapes |214| Chiaroscuro | Dramatic contrast | Art films, period pieces |215| Rim/backlight | Separation, ethereal | Silhouettes, divine presence |216| Practical | Realistic, natural | Candles, fires, lamps |217| God-rays | Divine, revelation | Spiritual moments, forests |218| Neon | Urban, futuristic | Cyberpunk, nightlife |219220### Color Grading221222| Style | Look | Genre |223|-------|------|-------|224| Teal-orange | Blockbuster cinematic | Action, sci-fi |225| Noir | High-contrast desaturated | Crime, mystery |226| Vintage/sepia | Warm, nostalgic | Period pieces, memory |227| Pastel | Soft, dreamy | Romance, coming-of-age |228| Bleach bypass | Desaturated, gritty | War, thriller |229| Cross-process | Surreal colors | Music videos, dreams |230231## Image Prompt Format232233When generating image prompts for AI tools:234235```236[Shot type] [camera angle] of [subject doing action], [visual style] style,237[lighting technique], [composition rule], [color grading],238[era-appropriate details], [mood keywords], highly detailed, cinematic239```240241Example:242```243Low-angle close-up of Kutil the purple rakshasa with mischievous golden eyes,244Pixar 3D style, dramatic underlighting with rim light, rule-of-thirds composition,245warm golden color grading, ancient Lanka palace background with ornate pillars,246playful yet mysterious mood, highly detailed, cinematic, 8k247```248249## Output Structure250251When saving a project, the following files are generated:252253```254Story Title/255├── 00_INDEX.md # Navigation256├── 01_SCRIPT_README.md # Human-readable script257├── 02_IMAGE_PROMPTS.md # All AI generation prompts258├── 03_CHARACTER_REFS.md # Character design guides259├── 04_VOICE_GUIDES.md # Dialogue consistency guides260├── 05_YOUTUBE_META.md # Title, description, tags261└── 99_CONTEXT_INFO.md # Story context and background262```263264## Important Rules2652661. **Always maintain character consistency** - include character's full visual description in every image prompt2672. **Never include anachronisms** - validate props, clothing, objects against the era2683. **Match cinematography to emotion** - use low angles for power, high angles for vulnerability2694. **Include both image and video prompts** - image prompts are static, video prompts describe motion2705. **Production-ready output** - every script should include enough detail for a team to produce it2716. **Respect the tone** - comedy needs comedic timing; drama needs longer holds on reactions272273## License274275MIT276277## Author278279Praveen Kumar