{"skill":{"slug":"cinematic-script-writer","displayName":"Cinematic Script Writer","summary":"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.","description":"---\nname: cinematic-script-writer\nversion: 1.4.0\ndescription: \"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.\"\nmetadata:\n  openclaw:\n    emoji: \"🎬\"\n    requires:\n      bins:\n        - node\n    install:\n      - id: npm-install\n        kind: npm\n        package: \"cinematic-script-writer\"\n        bins:\n          - cinematic-script\ntags:\n  - creative\n  - video\n  - script\n  - cinematography\n  - youtube\n  - camera\n  - lighting\n  - consistency\n  - character-design\n  - voice\n  - era-accurate\n  - storage\n  - google-drive\n---\n\n# Cinematic Script Writer\n\nCreate professional cinematic scripts for AI video generation with character consistency and cinematography knowledge.\n\n## Installation\n\n```bash\n# Install via npm\nnpm install -g cinematic-script-writer\n\n# Or install via OpenClaw CLI\nopenclaw skills install cinematic-script-writer\n```\n\n## CLI Usage\n\n### Context Management\n\nCreate and manage story contexts with characters, era, and settings:\n\n```bash\n# Create a new story context\ncinematic-script create-context --name \"My Story\" --era \"Ancient India\" --period \"Ramayana Era\"\n\n# List all saved contexts\ncinematic-script list-contexts\n\n# Get a specific context\ncinematic-script get-context --id <context-id>\n\n# Delete a context\ncinematic-script delete-context --id <context-id>\n```\n\n### Story Generation\n\nGenerate story ideas and create cinematic scripts:\n\n```bash\n# Generate story ideas for a context\ncinematic-script generate-ideas --context-id <context-id> --count 3\n\n# Create a full cinematic script from an idea\ncinematic-script create-script --context-id <context-id> --idea-id <idea-id>\n\n# Generate YouTube metadata for a script\ncinematic-script generate-metadata --script-id <script-id>\n```\n\n### Cinematography Reference\n\nAccess camera angles, lighting, and shot type databases:\n\n```bash\n# List all camera angles\ncinematic-script list-angles\n\n# List all camera movements\ncinematic-script list-movements\n\n# List all shot types\ncinematic-script list-shots\n\n# Get camera setup recommendation\ncinematic-script suggest-camera --scene-type \"dialogue\" --mood \"dramatic\"\n\n# Get lighting suggestions\ncinematic-script suggest-lighting --scene-type \"interior\" --mood \"mysterious\"\n\n# Get color grading suggestions\ncinematic-script suggest-grading --genre \"action\"\n\n# Search cinematography database\ncinematic-script search --query \"low angle lighting\"\n```\n\n### Character Consistency\n\nCreate character references and validate prompts:\n\n```bash\n# Create a character reference sheet\ncinematic-script create-character-ref --character-id \"char1\" --name \"Kutil\" --visual \"Purple rakshasa with golden eyes\" --era \"Ancient\" --style \"Pixar 3D\"\n\n# Create a voice profile for dialogue consistency\ncinematic-script create-voice --character-id \"char1\" --name \"Kutil\" --personality \"Mischievous, witty\" --age \"adult\" --role \"protagonist\"\n\n# Validate a prompt for anachronisms\ncinematic-script validate-prompt --prompt \"Your prompt here\" --character-ids \"char1,char2\" --context-id <context-id>\n```\n\n### Storage\n\nSave projects to Google Drive or local storage:\n\n```bash\n# Connect to Google Drive\ncinematic-script connect-drive\n\n# Connect to local storage\ncinematic-script connect-local\n\n# Check storage connection status\ncinematic-script storage-status\n\n# Save project to storage\ncinematic-script save --title \"My Story\" --context-id <context-id> --script-id <script-id>\n```\n\nStorage implementation details:\n- **Google Drive**: Uses Google OAuth2 for authentication. Credentials are stored securely in memory.\n- **Local Storage**: Saves to the user's downloads folder as fallback.\n- **Library**: Uses `googleapis` for Google Drive integration.\n\n### Export\n\nExport scripts in various formats:\n\n```bash\n# Export as Markdown (default)\ncinematic-script export --script-id <script-id> --format markdown\n\n# Export as JSON\ncinematic-script export --script-id <script-id> --format json\n\n# Export as plain text\ncinematic-script export --script-id <script-id> --format text\n```\n\n## Features\n\n- **Story Context Management**: Create and manage story settings, characters, and eras\n- **Story Idea Generation**: Generate multiple story concepts with hooks and twists\n- **Cinematic Script Writing**: Full scripts with camera angles, lighting, and shot types\n- **Character Consistency**: Reference sheets and voice profiles for consistent characters\n- **Environment Consistency**: Era-appropriate style guides and anachronism detection\n- **YouTube Metadata**: Generate titles, descriptions, and SEO tags\n- **Storage Integration**: Save to Google Drive or local storage\n- **Export Options**: JSON, Markdown, or plain text formats\n\n## When to Use\n\n- Writing cinematic scripts or screenplays\n- Creating stories with characters for animation/video\n- Generating image/video prompts for AI tools (Midjourney, Sora, Veo, Runway)\n- Getting cinematography guidance (camera angles, lighting, color grading)\n- Maintaining character consistency across scenes\n- Saving script projects to Google Drive\n\n## Cinematography Reference\n\n### Camera Angles\n\n| Angle | Emotional Impact | Best For |\n|-------|-----------------|----------|\n| Eye-level | Connection, equality, neutrality | Dialogue, emotional moments |\n| Low-angle | Power, dominance, heroism | Villain reveals, hero moments |\n| High-angle | Vulnerability, weakness, overview | Defeat, establishing scale |\n| Bird-eye | Insignificance, detachment, patterns | Epic scale, isolation |\n| Worm-eye | Awe, grandeur, overwhelming presence | Monuments, giants, deities |\n| Dutch angle | Unease, disorientation, tension | Chaos, dreams, horror |\n| Overhead | Omniscience, surveillance | Table scenes, fight choreography |\n| Shoulder-level | Intimate, casual, documentary feel | Walking conversations |\n| Hip-level | Cowboy feel, casual tension | Westerns, standoffs |\n| Knee-level | Childlike perspective, grounding | Children's stories, humility |\n\n### Camera Movements\n\n| Movement | Effect | Use For |\n|----------|--------|---------|\n| Static | Stability, observation | Contemplation, portraits |\n| Pan | Revealing space | Following action horizontally |\n| Tilt | Revealing height | Following vertical action |\n| Dolly | Immersion, intimacy | Moving toward/away from subject |\n| Truck | Following action | Side-to-side parallel movement |\n| Crane | Epic scale, drama | Sweeping reveals, transitions |\n| Handheld | Urgency, realism | Documentary, action, chaos |\n| Steadicam | Smooth floating | Following through space, dreams |\n| Zoom | Sudden focus, surprise | Dramatic emphasis, comedy |\n| Rack-focus | Revealing connections | Shifting attention between subjects |\n\n### Shot Types\n\n| Shot | Framing | Emotional Impact |\n|------|---------|-----------------|\n| Establishing | Wide location | Sets scene, geography, time |\n| Wide/Full | Subject + surroundings | Context, environment, scale |\n| Medium | Waist up | Dialogue, body language |\n| Close-up | Head/shoulders | Emotion, reaction, intimacy |\n| Extreme close-up | Detail only (eyes, hands) | Intense emotion, symbolism |\n| Over-shoulder | Past one subject to another | Conversation, perspective |\n| POV | Character's view | Immersion, subjectivity |\n| Insert | Object detail | Plot info, symbolism |\n| Two-shot | Two subjects together | Relationship, tension |\n\n### Lighting Techniques\n\n| Technique | Mood | Best For |\n|-----------|------|----------|\n| Three-point | Professional, balanced | Dialogue, interviews |\n| High-key | Happy, optimistic, bright | Comedy, commercials |\n| Low-key | Dramatic, mysterious | Drama, horror, noir |\n| Golden-hour | Romantic, nostalgic, magical | Romance, emotional moments |\n| Blue-hour | Melancholic, mysterious | Urban, cityscapes |\n| Chiaroscuro | Dramatic contrast | Art films, period pieces |\n| Rim/backlight | Separation, ethereal | Silhouettes, divine presence |\n| Practical | Realistic, natural | Candles, fires, lamps |\n| God-rays | Divine, revelation | Spiritual moments, forests |\n| Neon | Urban, futuristic | Cyberpunk, nightlife |\n\n### Color Grading\n\n| Style | Look | Genre |\n|-------|------|-------|\n| Teal-orange | Blockbuster cinematic | Action, sci-fi |\n| Noir | High-contrast desaturated | Crime, mystery |\n| Vintage/sepia | Warm, nostalgic | Period pieces, memory |\n| Pastel | Soft, dreamy | Romance, coming-of-age |\n| Bleach bypass | Desaturated, gritty | War, thriller |\n| Cross-process | Surreal colors | Music videos, dreams |\n\n## Image Prompt Format\n\nWhen generating image prompts for AI tools:\n\n```\n[Shot type] [camera angle] of [subject doing action], [visual style] style,\n[lighting technique], [composition rule], [color grading],\n[era-appropriate details], [mood keywords], highly detailed, cinematic\n```\n\nExample:\n```\nLow-angle close-up of Kutil the purple rakshasa with mischievous golden eyes,\nPixar 3D style, dramatic underlighting with rim light, rule-of-thirds composition,\nwarm golden color grading, ancient Lanka palace background with ornate pillars,\nplayful yet mysterious mood, highly detailed, cinematic, 8k\n```\n\n## Output Structure\n\nWhen saving a project, the following files are generated:\n\n```\nStory Title/\n├── 00_INDEX.md           # Navigation\n├── 01_SCRIPT_README.md   # Human-readable script\n├── 02_IMAGE_PROMPTS.md   # All AI generation prompts\n├── 03_CHARACTER_REFS.md  # Character design guides\n├── 04_VOICE_GUIDES.md    # Dialogue consistency guides\n├── 05_YOUTUBE_META.md    # Title, description, tags\n└── 99_CONTEXT_INFO.md    # Story context and background\n```\n\n## Important Rules\n\n1. **Always maintain character consistency** - include character's full visual description in every image prompt\n2. **Never include anachronisms** - validate props, clothing, objects against the era\n3. **Match cinematography to emotion** - use low angles for power, high angles for vulnerability\n4. **Include both image and video prompts** - image prompts are static, video prompts describe motion\n5. **Production-ready output** - every script should include enough detail for a team to produce it\n6. **Respect the tone** - comedy needs comedic timing; drama needs longer holds on reactions\n\n## License\n\nMIT\n\n## Author\n\nPraveen Kumar\n","tags":{"latest":"1.4.6"},"stats":{"comments":0,"downloads":4255,"installsAllTime":9,"installsCurrent":9,"stars":9,"versions":10},"createdAt":1770728911452,"updatedAt":1779076831124},"latestVersion":{"version":"1.4.6","createdAt":1770744503884,"changelog":"Cinematic Script Writer 1.4.6\n\n- Improved storage management logic and refactored storage adapter code.\n- Updated dependencies and adjusted package configurations.\n- Enhanced file handling reliability for both Google Drive and local storage.\n- Minor bug fixes and internal code clean up.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"praveenspeaks","userId":"s17252d50ks021cf061g7vc119885gpf","displayName":"praveenspeaks","image":"https://avatars.githubusercontent.com/u/62951236?v=4"},"moderation":null}