Cinematic Script Writer
Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge.
Installation
CODEBLOCK0
CLI Usage
Context Management
Create and manage story contexts with characters, era, and settings:
CODEBLOCK1
Story Generation
Generate story ideas and create cinematic scripts:
CODEBLOCK2
Cinematography Reference
Access camera angles, lighting, and shot type databases:
CODEBLOCK3
Character Consistency
Create character references and validate prompts:
CODEBLOCK4
Storage
Save projects to Google Drive or local storage:
CODEBLOCK5
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:
CODEBLOCK6
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:
CODEBLOCK7
Example:
CODEBLOCK8
Output Structure
When saving a project, the following files are generated:
CODEBLOCK9
Important Rules
- 1. 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
电影级剧本编写器
创建用于AI视频生成的专业电影级剧本，具备角色一致性和电影摄影知识。
安装
bash
通过npm安装
npm install -g cinematic-script-writer
或通过OpenClaw CLI安装
openclaw skills install cinematic-script-writer
CLI使用
上下文管理
创建和管理包含角色、时代和设定的故事上下文：
bash
创建新故事上下文
cinematic-script create-context --name 我的故事 --era 古印度 --period 罗摩衍那时代
列出所有已保存的上下文
cinematic-script list-contexts
获取特定上下文
cinematic-script get-context --id <上下文ID>
删除上下文
cinematic-script delete-context --id <上下文ID>
故事生成
生成故事创意并创建电影级剧本：
bash
为上下文生成故事创意
cinematic-script generate-ideas --context-id <上下文ID> --count 3
从创意创建完整电影级剧本
cinematic-script create-script --context-id <上下文ID> --idea-id <创意ID>
为剧本生成YouTube元数据
cinematic-script generate-metadata --script-id <剧本ID>
电影摄影参考
访问摄像机角度、灯光和镜头类型数据库：
bash
列出所有摄像机角度
cinematic-script list-angles
列出所有摄像机运动
cinematic-script list-movements
列出所有镜头类型
cinematic-script list-shots
获取摄像机设置建议
cinematic-script suggest-camera --scene-type 对话 --mood 戏剧性
获取灯光建议
cinematic-script suggest-lighting --scene-type 室内 --mood 神秘
获取调色建议
cinematic-script suggest-grading --genre 动作
搜索电影摄影数据库
cinematic-script search --query 低角度灯光
角色一致性
创建角色参考并验证提示词：
bash
创建角色参考表
cinematic-script create-character-ref --character-id char1 --name 库蒂尔 --visual 紫色罗刹，金色眼睛 --era 古代 --style 皮克斯3D
创建语音档案以保持对话一致性
cinematic-script create-voice --character-id char1 --name 库蒂尔 --personality 调皮、机智 --age 成年 --role 主角
验证提示词是否存在时代错误
cinematic-script validate-prompt --prompt 您的提示词 --character-ids char1,char2 --context-id <上下文ID>
存储
将项目保存到Google Drive或本地存储：
bash
连接到Google Drive
cinematic-script connect-drive
连接到本地存储
cinematic-script connect-local
检查存储连接状态
cinematic-script storage-status
将项目保存到存储
cinematic-script save --title 我的故事 --context-id <上下文ID> --script-id <剧本ID>
存储实现细节：
- - Google Drive：使用Google OAuth2进行身份验证。凭据安全地存储在内存中。
- 本地存储：作为备用方案保存到用户的下载文件夹。
- 库：使用googleapis进行Google Drive集成。
导出
以多种格式导出剧本：
bash
导出为Markdown（默认）
cinematic-script export --script-id <剧本ID> --format markdown
导出为JSON
cinematic-script export --script-id <剧本ID> --format json
导出为纯文本
cinematic-script export --script-id <剧本ID> --format text
功能特性
- - 故事上下文管理：创建和管理故事设定、角色和时代
- 故事创意生成：生成多个带有钩子和转折的故事概念
- 电影级剧本编写：包含摄像机角度、灯光和镜头类型的完整剧本
- 角色一致性：角色参考表和语音档案，确保角色一致
- 环境一致性：符合时代的风格指南和时代错误检测
- YouTube元数据：生成标题、描述和SEO标签
- 存储集成：保存到Google Drive或本地存储
- 导出选项：JSON、Markdown或纯文本格式
使用场景
- - 编写电影级剧本或剧本
- 为动画/视频创作带角色的故事
- 为AI工具生成图像/视频提示词（Midjourney、Sora、Veo、Runway）
- 获取电影摄影指导（摄像机角度、灯光、调色）
- 保持跨场景的角色一致性
- 将剧本项目保存到Google Drive
电影摄影参考
摄像机角度
| 角度 | 情感影响 | 最佳用途 |
|---|
| 平视 | 连接、平等、中立 | 对话、情感时刻 |
| 低角度 |
力量、支配、英雄主义 | 反派登场、英雄时刻 |
| 高角度 | 脆弱、软弱、全景 | 失败、确立规模 |
| 鸟瞰 | 渺小、疏离、图案 | 史诗规模、孤立 |
| 虫眼 | 敬畏、宏伟、压倒性存在 | 纪念碑、巨人、神祇 |
| 荷兰角 | 不安、迷失、紧张 | 混乱、梦境、恐怖 |
| 俯拍 | 全知、监视 | 桌面场景、打斗编排 |
| 肩平 | 亲密、随意、纪录片感 | 行走对话 |
| 腰平 | 牛仔感、随意紧张 | 西部片、对峙 |
| 膝平 | 儿童视角、接地气 | 儿童故事、谦卑 |
摄像机运动
揭示空间 | 水平跟随动作 |
| 俯仰 | 揭示高度 | 垂直跟随动作 |
| 推拉 | 沉浸、亲密 | 靠近/远离主体 |
| 横移 | 跟随动作 | 侧向平行移动 |
| 升降 | 史诗规模、戏剧性 | 扫视揭示、转场 |
| 手持 | 紧迫、真实 | 纪录片、动作、混乱 |
| 斯坦尼康 | 平滑漂浮 | 穿越空间跟随、梦境 |
| 变焦 | 突然聚焦、惊喜 | 戏剧性强调、喜剧 |
| 焦点转移 | 揭示联系 | 在主体间转移注意力 |
镜头类型
| 镜头 | 构图 | 情感影响 |
|---|
| 定场 | 宽场景 | 设定场景、地理、时间 |
| 全景/全身 |
主体+环境 | 背景、环境、规模 |
| 中景 | 腰部以上 | 对话、肢体语言 |
| 特写 | 头部/肩膀 | 情感、反应、亲密 |
| 极特写 | 仅细节（眼睛、手） | 强烈情感、象征 |
| 过肩 | 经过一个主体到另一个 | 对话、视角 |
| 主观 | 角色视角 | 沉浸、主观性 |
| 插入 | 物体细节 | 情节信息、象征 |
| 双人 | 两个主体一起 | 关系、紧张 |
灯光技巧
快乐、乐观、明亮 | 喜剧、广告 |
| 低调 | 戏剧性、神秘 | 戏剧、恐怖、黑色电影 |
| 黄金时刻 | 浪漫、怀旧、魔幻 | 浪漫、情感时刻 |
| 蓝色时刻 | 忧郁、神秘 | 都市、城市景观 |
| 明暗对比 | 戏剧性对比 | 艺术电影、年代片 |
| 轮廓/背光 | 分离、空灵 | 剪影、神圣存在 |
| 实用光源 | 真实、自然 | 蜡烛、火、灯 |
| 神光 | 神圣、启示 | 灵性时刻、森林 |
| 霓虹 | 都市、未来 | 赛博朋克、夜生活 |
调色
高对比度去饱和 | 犯罪、悬疑 |
| 复古/怀旧 | 温暖、怀旧 | 年代片、回忆 |
| 粉彩 | 柔和、梦幻 | 浪漫、成长 |
| 漂白 | 去饱和、粗粝 | 战争、惊悚 |
| 交叉冲印 | 超现实色彩 | 音乐视频、梦境 |
图像提示词格式
为AI工具生成图像提示词时：
[镜头类型] [摄像机角度] 的 [主体做动作]，[视觉风格] 风格，
[灯光技巧]，[构图规则]，[调色]，
