cinematic-script-writer について
Cinematic Script Writerは、映画的な脚本やAI動画プロンプトを作るCLIスキルです。脚本家や動画制作者向けに、ストーリー設定とアイデア生成、撮影参考、キャラクターの一貫性を保つ機能、保存、複数形式での書き出しを備えています。
主な機能
- 01ストーリー設定とキャラクターの管理
- 02アイデアと映画的な脚本の生成
- 03カメラアングル、動き、ショットの参照
- 04キャラクターと声のリファレンス作成
- 05プロンプトの時代錯誤チェック
- 06プロジェクトファイルの保存と書き出し
活用シーン
- 01アニメーションや動画の脚本制作
- 02AI画像・動画ツール向けプロンプトの作成
- 03シーン間でキャラクターの一貫性を維持
- 04脚本をMarkdown、JSON、テキストで書き出し
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/cinematic-script-writerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignore.eslintrc.jsonLICENSECONTRIBUTING.mdCHANGELOG.mdREADME.mdSETUP-GUIDE.mdpackage.jsonpackage-lock.jsonreport.md.claude/settings.local.json.github/workflows/ci.ymlbin/cinematic-script.tsexamples/file-manager-skill/index.tsskill.jsonexamples/todo-skill/skill.jsonindex.tsexamples/weather-skill/README.mdindex.tsschema.jsonskill.jsonskill-template/skill.jsonindex.tsREADME.mdschema.jsonskill-template/tests/index.test.tsskills/cinematic-script-writer/EXAMPLE-KUTIL.mdEXAMPLE-CONSISTENCY.mdEXAMPLE-STORAGE.mdREADME.md詳細
シネマティック脚本ライター
キャラクターの一貫性と撮影技法の知識を活かし、AI 動画生成向けのプロフェッショナルなシネマティック脚本を作成します。
インストール
# Install via npm
npm install -g cinematic-script-writer
# Or install via OpenClaw CLI
openclaw skills install cinematic-script-writer
CLI の使用方法
コンテキスト管理
キャラクター、時代、設定を含むストーリーコンテキストを作成・管理します。
# 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>
ストーリー生成
ストーリーのアイデアを生成し、シネマティック脚本を作成します。
# 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>
撮影技法リファレンス
カメラアングル、照明、ショットタイプのデータベースを参照します。
# 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"
キャラクターの一貫性
キャラクターのリファレンスを作成し、プロンプトを検証します。
# 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>
ストレージ
プロジェクトを Google Drive またはローカルストレージに保存します。
# 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>
ストレージの実装詳細：
- Google Drive：認証には Google OAuth2 を使用します。認証情報はメモリ内に安全に保存されます。
- ローカルストレージ：フォールバックとして、ユーザーのダウンロードフォルダーに保存します。
- ライブラリ：Google Drive との連携には
googleapisを使用します。
エクスポート
さまざまな形式で脚本をエクスポートします。
# 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
機能
- ストーリーコンテキスト管理：ストーリーの設定、キャラクター、時代を作成・管理します
- ストーリーアイデアの生成：フックやどんでん返しを含む複数のストーリー構想を生成します
- シネマティック脚本の執筆：カメラアングル、照明、ショットタイプを盛り込んだ完全な脚本を作成します
- キャラクターの一貫性：キャラクターの一貫性を保つためのリファレンスシートと音声プロフィールを用意します
- 環境の一貫性：時代に適したスタイルガイドと時代錯誤の検出を行います
- YouTube メタデータ：タイトル、説明、SEO タグを生成します
- ストレージ連携：Google Drive またはローカルストレージに保存します
- エクスポート形式：JSON、Markdown、プレーンテキスト形式に対応します
使用する場面
- シネマティック脚本やスクリーンプレイを執筆する
- アニメーションや動画向けにキャラクターのいるストーリーを作成する
- AI ツール（Midjourney、Sora、Veo、Runway）用の画像・動画プロンプトを生成する
- 撮影技法のガイダンス（カメラアングル、照明、カラーグレーディング）を得る
- シーン全体でキャラクターの一貫性を保つ
- 脚本プロジェクトを Google Drive に保存する
撮影技法リファレンス
カメラアングル
| アングル | 感情への影響 | 適した用途 |
|---|---|---|
| アイレベル | 共感、対等さ、中立性 | 会話、感情的な場面 |
| ローアングル | 力、優位性、英雄性 | 悪役の登場、ヒーローの場面 |
| ハイアングル | 弱さ、無力さ、俯瞰 | 敗北、規模感を示す場面 |
| バードアイ | 取るに足らなさ、距離感、パターン | 壮大なスケール、孤立 |
| ワームアイ | 畏敬、壮大さ、圧倒的な存在感 | モニュメント、巨人、神々 |
| ダッチアングル | 不安、方向感覚の喪失、緊張感 | 混乱、夢、ホラー |
| オーバーヘッド | 全知、監視 | テーブルを囲む場面、戦闘の振り付け |
| ショルダーレベル | 親密さ、気軽さ、ドキュメンタリー感 | 歩きながらの会話 |
| ヒップレベル | カウボーイ風、気軽な緊張感 | 西部劇、対決 |
| ニーレベル | 子どものような視点、地に足のついた感覚 | 子ども向けの物語、謙虚さ |
カメラの動き
| 動き | 効果 | 用途 |
|---|---|---|
| 固定 | 安定感、観察 | 熟考、ポートレート |
| パン | 空間を見せる | 水平方向に動きを追う |
| チルト | 高さを見せる | 垂直方向の動きを追う |
| ドリー | 没入感、親密さ | 被写体に近づく・離れる |
| トラック | 動きを追う | 横方向に平行移動する |
| クレーン | 壮大なスケール、ドラマ性 | 大きく見せるショット、場面転換 |
| 手持ち | 緊迫感、リアリティ | ドキュメンタリー、アクション、混乱 |
| ステディカム | 滑らかに浮遊する動き | 空間内を追う、夢 |
| ズーム | 急な焦点合わせ、驚き | ドラマチックな強調、コメディ |
| ラックフォーカス | 関連性を明らかにする | 被写体間で注意を移す |
ショットの種類
| ショット | フレーミング | 感情への影響 |
|---|---|---|
| エスタブリッシングショット | 場所を広く捉える | シーン、地理、時間を示します |
| ワイド／フルショット | 被写体と周囲 | 文脈、環境、規模を伝えます |
| ミディアムショット | 腰から上 | 会話、ボディランゲージを捉えます |
| クローズアップ | 頭部／肩 | 感情、反応、親密さを捉えます |
| エクストリームクローズアップ | 細部のみ（目、手など） | 強い感情、象徴性を表現します |
| オーバーショルダー | ある被写体越しに別の被写体を捉える | 会話、視点を表現します |
| POV | キャラクターの視点 | 没入感、主観性を生みます |
| インサート | 物の細部 | プロット情報、象徴性を伝えます |
| ツーショット | 2人の被写体を一緒に捉える | 関係性、緊張感を表現します |
照明技法
| 技法 | ムード | 最適な用途 |
|---|---|---|
| 三点照明 | プロフェッショナル、バランスの取れた印象 | 会話、インタビュー |
| ハイキー | 楽しく、楽観的で、明るい印象 | コメディ、コマーシャル |
| ローキー | ドラマチックで、ミステリアスな印象 | ドラマ、ホラー、ノワール |
| ゴールデンアワー | ロマンチックで、ノスタルジックで、幻想的な印象 | ロマンス、感情的な場面 |
| ブルーアワー | メランコリックで、ミステリアスな印象 | 都会、都市の風景 |
| キアロスクーロ | ドラマチックなコントラスト | アート映画、時代劇 |
| リムライト／逆光 | 分離感、幻想的な印象 | シルエット、神々しい存在 |
| 実景光源 | リアルで、自然な印象 | ろうそく、炎、ランプ |
| ゴッドレイ | 神聖さ、啓示 | スピリチュアルな場面、森 |
| ネオン | 都会的で、未来的な印象 | サイバーパンク、ナイトライフ |
カラーグレーディング
| スタイル | 見た目 | ジャンル |
|---|---|---|
| ティール＆オレンジ | ブロックバスター映画のようなシネマティックな印象 | アクション、SF |
| ノワール | 高コントラストで彩度を落とした印象 | 犯罪、ミステリー |
| ビンテージ／セピア | 暖かく、ノスタルジックな印象 | 時代劇、記憶 |
| パステル | 柔らかく、夢のような印象 | ロマンス、青春もの |
| ブリーチバイパス | 彩度を落とした、粗削りな印象 | 戦争、スリラー |
| クロスプロセス | シュールな色合い | ミュージックビデオ、夢 |
画像プロンプトの形式
AI ツール向けの画像プロンプトを生成する場合：
[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
例：
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
出力構成
プロジェクトを保存すると、次のファイルが生成されます：
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
重要なルール
- キャラクターの一貫性を常に保ってください - すべての画像プロンプトに、キャラクターの視覚的な特徴を詳しく記載してください
- 時代錯誤な要素は決して含めないでください - 小道具、衣服、物が時代に合っているか確認してください
- 撮影技法を感情に合わせてください - 力強さにはローアングル、弱さにはハイアングルを使ってください
- 画像プロンプトと動画プロンプトの両方を含めてください - 画像プロンプトは静止画を、動画プロンプトは動きを描写します
- 制作に使える出力にしてください - すべての脚本に、チームが制作するために十分な詳細を含めてください
- トーンを守ってください - コメディには笑いの間が必要です。ドラマでは反応を長めに映してください
ライセンス
MIT
作者
Praveen Kumar
コメント
Markdown 対応