Cinematic Script Writer

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.

Security Scan

The skill's code, CLI, and install method are consistent with its stated purpose (cinematic script generation, cinematography references, character consistency, and optional Google Drive/local storage); nothing in the bundle indicates clear misdirection or hidden exfiltration, but a few implementation and supply-chain details deserve review before install.

Purpose & Capability

Name/description align with the actual files: the repo includes a CLI, cinematography databases, a consistency system, prompt builder, and storage adapters. Requiring node and distributing as an npm package (openclaw-skills) is proportionate to a TypeScript/Node CLI skill.

Instruction Scope

SKILL.md and the CLI only direct typical operations for script generation, cinematography lookups, prompt building, and storage. The storage features include Google Drive OAuth and a local 'Downloads' fallback — that implies filesystem writes and an OAuth browser flow. The instructions do not appear to ask for unrelated system secrets, but local storage will access the user's Downloads folder and the Drive connect action will cause HTTP traffic and an auth flow; review storage-adapter.ts/storage-manager.ts to confirm tokens are not silently persisted or exfiltrated.

Install Mechanism

Installation is via npm (package: openclaw-skills), which is a standard package registry install. No external arbitrary download URLs or extract-from-URL steps are used in the provided install spec. As with any npm package, verify the package authorship and checksum on the registry before global install.

Credentials

The skill declares no required environment variables or primary credential, which is reasonable for an interactive Google OAuth flow. However SKILL.md mentions using the googleapis library and Google OAuth2; ensure the library/dependency is present (I noticed the top-level package.json lists only 'uuid' in dependencies — confirm the cinematography skill's package.json includes googleapis if Drive integration is implemented). The skill also writes to the local Downloads folder when using local storage, which involves filesystem access that should be expected and reviewed.

Persistence & Privilege

always:false (not force-included) and model invocation is allowed (default). The skill does not request 'always' or other elevated platform privileges in the metadata provided. Review the skill.json under skills/cinematic-script-writer/skill.json to confirm declared runtime permissions (memory/http/fs) before granting the agent broad abilities.

Assessment

This skill appears to do what it claims (script generation, cinematography guides, prompt building) and installs via npm, but before installing: 1) Verify the npm package author and version on the npm registry (openclaw-skills) and inspect the package contents or source repo to ensure they match what you see here. 2) Open the storage-adapter.ts and storage-manager.ts files to confirm how Google OAuth tokens are handled (look for any code that writes tokens to a remote endpoint or to disk). 3) Confirm whether googleapis (or another Drive client) is listed as a dependency in the skill-specific package.json—if Drive integration is expected but the dependency is missing, that could be an oversight or indicate a mismatch. 4) Be aware the skill can write to your local Downloads folder when using local storage—if you need to limit filesystem access, run it in a sandbox/container. 5) If you plan to use the Google Drive integration, only proceed with the interactive OAuth flow and verify the consent screen and scope requested; do not paste service account keys or secrets into the CLI. 6) If you are unsure, test the package in an isolated environment (container or VM) first and inspect runtime network traffic and file writes.

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

Installation

# Install via npm
npm install -g openclaw-skills

# 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

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