mcpField
V
video-storyboard

video-storyboard

github.com/agentaraクリエイティブ・メディア619879 回インストール4 週間前に更新
リポジトリ

video-storyboard について

video-storyboardは、映像シーン向けの制作可能なストーリーボード一式を作るスキルです。画像生成モデルによるラベル付きシートと、タイミングや連続性を反映した動画生成プロンプトを作成します。

主な機能

  1. 01画像生成モデルによる絵コンテ
  2. 02シーン尺に応じたグリッド
  3. 03パネル番号と時間表示
  4. 04キャラクターと場面の連続性確認
  5. 05動画生成用プロンプトの作成

活用シーン

  1. 01映像シーンの絵コンテを計画
  2. 02絵コンテから時間付きプロンプトを作成
  3. 03シーン間のキャラクター一貫性を維持

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agentara/skills --skill video-storyboard

インストール後、Claude Code で/video-storyboardを入力して読み込まれたか確認します。

詳細

ビデオストーリーボード

このスキルを使用して、特定のシーン用の本番環境に対応したストーリーボード一式を作成します。

  1. storyboard/scene-XX.png に保存するストーリーボード画像。
  2. storyboard/scene-XX.md に保存する動画生成プロンプトのスクリプト。

スキルの手順は英語で記述しますが、ユーザーが別の言語を明示的に指定しない限り、ユーザー向けの .md スクリプトはユーザーの希望するローカル言語で作成します。

画像生成要件

ストーリーボード画像は画像生成モデルで生成する必要があります。コード、SVG、HTML/CSS、キャンバス、図、プレースホルダーのイラスト、決定論的な図形スクリプトでストーリーボードのアートワークを作成しないでください。これらの方法は、ビジュアル以外のメタデータやファイル操作に限り使用でき、ストーリーボード画像の代替としては使用できません。

特に指定がない限り、組み込みの image_gen ツールを使用してください。明示的に必須とされている場合は、承認済みのプロジェクト画像生成ワークフローを使用してください。生成後、モデルが生成したラスター出力を storyboard/scene-XX.png に保存またはコピーしてください。モデルの出力を直接保存できない場合は、生成されたラスターアセットを見つけて、指定されたパスに移動またはコピーしてください。プログラムで再作成しないでください。

使用するタイミング

次のいずれかをユーザーが依頼した場合に、このスキルを使用してください。

  • シーンのストーリーボードを生成する。
  • 動画プランのシーンをストーリーボードのフレームにする。
  • ストーリーボードのパネルから動画を生成するためのプロンプトを作成する。
  • scene-01、scene-02 などのストーリーボード画像とプロンプトスクリプトを保存する。
  • パネルごとのタイミングラベル付きのグリッドストーリーボードを作成する。

ユーザーがストーリーボード画像だけを依頼した場合も、ワークフローで対応する .md プロンプトスクリプトが必要かどうかを検討してください。不明な場合は、簡潔な質問を1つするか、ユーザーが以前このワークフローを利用している場合は、両方のファイルを作成してください。

抽出する入力情報

生成前に、次の項目を特定してください。

  • シーン番号。
  • シーンの長さ。
  • シーンの情報源:既存のプラン、以前の会話、ユーザーのプロンプト、アップロードされた画像、またはファイル。
  • 最終動画のアスペクト比。指定がなければ通常は 16:9 です。
  • キャラクターと外見の一貫性に関する制約。
  • 利用可能なキャラクターデザイン素材:.png のキャラクターシート、.md のキャラクター仕様書、三面図、キャスティング参考資料、または以前に承認されたキャラクター画像。
  • 衣装、小道具、ブランドや製品の詳細、場所。
  • ビジュアルスタイルと参考資料。
  • .md プロンプトスクリプトの出力言語。

シーン番号がない場合は、ユーザーに確認してください。長さが不明な場合は、参照されているプランから推定してください。それ以外の場合は、確認するか、ユーザーが作業の続行を希望している場合に限り、実用的なデフォルト値を選んでください。

出力パス

シーン番号は必ず2桁にしてください。

  • シーン1 -> storyboard/scene-01.png と storyboard/scene-01.md
  • シーン2 -> storyboard/scene-02.png と storyboard/scene-02.md
  • シーン12 -> storyboard/scene-12.png と storyboard/scene-12.md

storyboard/ が存在しない場合は作成してください。

ユーザーから再生成または置き換えを依頼されていない限り、既存のストーリーボードファイルを上書きしないでください。対象ファイルが存在する場合は、置き換え前に確認するか、ユーザーが別案を求めている場合は scene-01-v2.png のような明確な改訂版パスに保存してください。

グリッドのルール

シーンの長さに応じてグリッドサイズを選んでください。

シーンの長さグリッドパネル数
<= 9s3 rows x 3 columns9パネル
> 9s and <= 12s4 rows x 3 columns12パネル
> 12s4 rows x 4 columns16パネル

各パネルは 16:9 にしてください。

パネル間に隙間を設けないでください。読みやすさのために必要な場合に限り、細い黒の境界線を使えますが、余白や間隔は入れないでください。

シーンの長さを均等に分割できない場合は、実用的なパネルごとの長さを割り当ててください。必要に応じて、0.5s、1s、1.5s、2s のようなシンプルなラベルや、正確な範囲を使ってください。非常に短いシーンでは、すべてのパネルに動作を詰め込むと細分化しすぎる場合に限り、最後のパネルを空にできます。空のパネルは無地の黒にしてください。

ストーリーボード画像の要件

複数の画像ではなく、1枚のストーリーボードシートを生成してください。

ストーリーボードシート自体を画像生成モデルで作成してください。プロンプトでは、グリッド全体、パネルのラベル、連続性の要件、ビジュアルスタイルを明確に指定してください。SVGでグリッドを実装したり、コードでパネルを手作業で描画したりしないでください。

ストーリーボード画像を生成する前に、まず現在の会話やコンテキスト内に既存のキャラクター画像がないか確認してください。プロジェクト内で以前に生成された画像も対象です。その後、現在のプロジェクトで characters/ または storyboard/ の下にある、特に .png ファイル、キャラクターシート、ターンアラウンドシート、承認済みの参照画像など、該当するキャラクターアセットを探してください。

関連するキャラクター画像がある場合は、ストーリーボードの参照画像として必ず画像生成モデルに渡してください。キャラクター画像が利用できる場合に、テキストの説明だけに頼らないでください。

現在のコンテキストにキャラクターデザイン画像、承認済みのキャラクターシート、ターンアラウンドシート、またはキャラクター参照用の .png が含まれている場合は、ストーリーボード画像の生成時にその画像を参照画像として使用してください。これは、シーンを通じてアイデンティティ、顔、髪型、体のプロポーション、衣装、素材のディテールを一貫させるために必須です。

キャラクターの .md 仕様書と .png シートの両方がある場合は、記述された制約を確認するために .md を読み、視覚的な参照画像として .png を画像生成モデルに渡してください。

目に見える各パネルには、次の要素を必ず含めてください。

  • 左上隅に、パネル番号を白い文字で表示した黒い長方形。番号は 1 から始めてください。
  • 右上隅に、パネルの長さを白い文字で表示した黒い長方形。例:0.5s、1s、1.5s。
  • パネルのビートに対応する、明確なショット構図。

パネルのバリエーションは非常に重要です。

  • 同一、酷似、または視覚的に冗長なパネルを2つ作らないでください。
  • 空でない各パネルでは、アクションを進める、新しい情報を明らかにする、または視点を変えるようにしてください。
  • 連続性を保ちながら、ショットサイズ、カメラアングル、キャラクターのポーズ、ジェスチャー、小道具とのやり取り、前景と背景の関係、動きの方向に変化をつけてください。
  • 繰り返しが意図的で、シーンのリズムに明確な効果をもたらす場合を除き、クローズアップやワイドショットを繰り返さないでください。

重要な連続性の要件:

  • すべてのパネルで同じキャラクターのアイデンティティを保ってください。
  • 顔、年齢、髪型、体型、肌の色を一貫させてください。
  • シーンで明示的に衣装が変わる場合を除き、衣装を一貫させてください。
  • 商品の形状や色、ボトルや缶のデザイン、バッグ、カメラ、乗り物、荷物など、重要な小道具を一貫させてください。
  • 場所の地理的な配置を一貫させてください。ドア、窓、道路、自動販売機、教室、ランドマーク、フィールドの向き、光の向きなどを不規則に変えないでください。
  • シーンで明示的に移行する場合を除き、時刻と天候を一貫させてください。

画像生成プロンプトを作成する際は、画像モデルが連続性の要件を守れるよう、それらを明確かつ十分に繰り返し記載してください。装飾的なスタイルよりも、これが重要です。

キャラクターデザインの参照画像を使用する場合は、ストーリーボードのキャラクターをその参照画像に一致させるよう、画像モデルに明確に指示してください。顔、髪型、年齢、体のプロポーション、衣装、靴、アクセサリー、衣服の素材、カラーパレットを同じにしてください。ポーズ、アクション、カメラアングル、照明は変えてもかまいませんが、キャラクターデザインは変えないでください。

次の要素は避けてください。

  • AIらしい顔、蝋のような肌、歪んだ手、余分な指。
  • 衣服、髪、小道具、背景が不規則に変わること。
  • 制御されていない読み取り可能な文字や、崩れたブランドのタイポグラフィ。
  • 余分なロゴ、字幕、吹き出し、UIオーバーレイ、透かし。
  • シーンを現実的に見せるべき場合の、過度に映画的なファンタジー風の照明。

ブランドや製品に関する作業では、ユーザーから公式アセットが提供されない限り、「ブランドカラーと製品形状の手がかり」を優先してください。パッケージに生成される文字は、信頼できないことがよくあります。

推奨する画像プロンプトの構成

画像生成プロンプトには、次の構成を使用してください。

Create a single storyboard sheet for Scene [XX], [duration] seconds, [video aspect/style].

Use the provided character design image as the primary visual reference for the character. Match the same face, hairstyle, body proportions, wardrobe, shoes, accessories, clothing material details, and color palette across all panels.

Grid: [3x3 / 4x3 / 4x4], every panel is 16:9, no gaps between panels.
Panel labels: top-left black label with white panel number; top-right black label with white duration.

Continuity is critical: the same [character description] appears consistently across all panels, same face, same hairstyle, same wardrobe, same props, same location geography, same lighting direction, same time of day.

Panel variety is critical: no two non-empty panels should look identical or overly similar. Each panel must have a distinct shot composition, action beat, camera angle, shot size, gesture, prop interaction, or foreground/background arrangement while still preserving continuity.

Scene summary: [one concise scene summary].
Visual style: [photorealistic / cinematic / documentary / commercial / handheld / natural light].

Panels:
1. [duration] - [shot type, action, composition]
2. [duration] - [shot type, action, composition]
...

Negative constraints: no subtitles, no extra logos, no watermarks, no distorted text, no inconsistent character, no clothing changes, no prop changes, no AI-smooth skin, no deformed hands.

動画プロンプトスクリプトの要件

画像を作成した後、動画生成用の対応する .md ファイルを作成します。

スクリプトでは、動画モデルがストーリーボードから連続した1つのシーンを生成できるようにします。連続性、スタイル、ショットのタイミング、キャラクターの動作、サウンドデザイン、編集のリズム、ネガティブプロンプトを記述してください。

スクリプトには、ユーザーが希望する現地語を使用します。ユーザーが中国語で書いた場合は、.md も中国語で書きます。

次の構成を使用します。

根据上传的 01-[NN] 分镜图,生成一段 [duration] 秒 [style] 场景。

[Continuity paragraph: same characters, wardrobe, props, location, time of day.]

[Restrictions paragraph: no subtitles, no voiceover unless requested, no extra logos, no readable text if risky.]

风格:[visual style, camera feel, color, texture.]

节奏:[overall edit rhythm.]

---

## 01 | 00:00-00:00.5

[Panel description.]

[Character action.]

[Camera movement / shot type / transition.]

---

## 02 | 00:00.5-00:01.0

[...]

---

## 声音设计

[Natural sound, music, transitions, sound bridges.]

## 剪辑建议

[How the panels should connect into motion.]

## 负向提示词

- [No subtitles]
- [No extra logos]
- [No inconsistent character]
- [No wardrobe changes]
- [No prop changes]
- [No unreadable or distorted text]

ユーザーが英語または別の言語を指定した場合は、見出しを翻訳します。

スクリプトのタイミング規則

.md スクリプトは、ストーリーボード画像と一致させる必要があります。

  • 最後のパネルを意図的に空白にする場合を除き、グリッドと同じパネル数にします。
  • 画像のラベルと同じパネルごとの長さにします。
  • タイムコードの合計をシーンの長さと正確に一致させます。
  • 各パネルには、短いシーン全体ではなく、1つの視覚的なビートを記述します。
  • テンポの速いシーンでは0.5秒のビート、ゆっくりしたシーンでは1~2秒のビートを使用できます。

5秒の3x3ボードの場合、次の設定が適切な初期値です。

  • パネル1~8:各0.5s。
  • パネル9:1s。

9秒の3x3ボードの場合、次の設定が適切な初期値です。

  • パネル1~9:各1s。

12秒の4x3ボードの場合、次の設定が適切な初期値です。

  • パネル1~12:各1s。

15秒の4x4ボードの場合、次の設定が適切な初期値です。

  • パネル1~14:各1s。
  • パネル15:0.5s。
  • パネル16:0.5s。

シーンのアクションに応じて、強調箇所が適切になるよう調整してください。

ワークフロー

  1. 関連するプラン、前のシーンのスクリプト、既存のストーリーボード、またはユーザーが提供したシーンの説明を確認します。
  2. 現在の会話やコンテキストを検索し、プロジェクト内で以前に生成された画像やユーザーが添付した画像など、既存のキャラクター画像を探します。
  3. 現在のプロジェクトのcharacters/フォルダーを検索し、対応するキャラクター画像を探します。特にcharacters/*.png、承認済みのキャラクターシート、ターンアラウンド、対応する{character-name}.mdの仕様を確認します。
  4. 関連するキャラクターデザイン画像がどちらかの場所にある場合は、ストーリーボードの生成時に参照画像として含めます。キャラクターの一貫性を保つために必須です。
  5. シーンの長さ、物語上の目的、キャラクター、衣装、小道具、場所、カメラ表現、編集のビートを抽出します。
  6. シーンの長さに応じてグリッドサイズを選びます。
  7. 正確な長さとタイムコードを含むパネルのビートを下書きします。
  8. 画像生成モデル/ツールを使ってストーリーボード画像を生成します。利用可能なキャラクターデザイン画像があれば、視覚的な参照として使用します。SVG、コードによる描画、キャンバス、HTML/CSS、プレースホルダーアートで代用してはいけません。
  9. 生成した画像をstoryboard/scene-XX.pngに保存するか、そこにコピーします。
  10. 可能であれば画像を確認します。グリッド、ラベル、連続性、明らかな視覚的な不具合がないか検証します。
  11. 同じパネルのタイミングと説明を使用して、storyboard/scene-XX.mdを作成します。
  12. 最終回答には保存したファイルパスを含め、対応している場合は絶対パスを使ったMarkdown画像タグで画像を表示します。

品質チェックリスト

完了する前に、次の項目を確認してください。

  • storyboard/scene-XX.pngが存在する。
  • storyboard/scene-XX.mdが存在する。
  • シーン番号が2桁である。
  • グリッドサイズがシーンの長さの規則に一致している。
  • 現在のコンテキストに既存または生成済みのキャラクター画像がないか確認した。
  • プロジェクトのcharacters/フォルダーに対応するキャラクター画像がないか確認した。
  • コンテキストまたはcharacters/に利用可能なキャラクターデザイン画像がある場合、生成時の参照画像として使用した。
  • 空白ではない各パネルに、番号と長さのラベルが付いている。
  • 空白ではないパネルに、同一、ほぼ同一、または視覚的に重複するものがない。
  • パネルの長さの合計がシーンの長さと一致している。
  • .md スクリプトが画像のパネル順序と一致している。
  • キャラクターの一貫性が画像プロンプトと.mdスクリプトの両方で明示されている。
  • 衣装、小道具、場所の一貫性が明示されている。
  • .mdスクリプトの出力言語がユーザーの希望に一致している。

例:5秒のコマーシャルシーン

ユーザーの依頼:

Create storyboard and video prompt for Scene 01: 5-second campus sports drink TVC opener.

以下を使用します:

  • グリッド:3x3。
  • パネル数:9。
  • タイミング:最初の8パネルは0.5s、最後のパネルは1s。
  • 出力ファイル:storyboard/scene-01.png、storyboard/scene-01.md。
  • 連続性で重視する点:同じ生徒、同じ学校の制服、同じ青白のドリンクボトル、同じ朝のキャンパスの場所。

パネルの構成例:

パネル時間ビート
10.5s朝のキャンパスの光の中にある自動販売機のクローズアップ
20.5sボトルが取り出し口に落ちる
30.5s生徒の手がボトルに伸びる
40.5sボトルが持ち上げられ、結露が光を受ける
50.5s生徒が運動場のほうを見る
60.5s校門のワイドショット
70.5s生徒がキャンパスの小道を歩き始める
80.5sスニーカーが走り出す最初の一歩をローアングルで撮影
91sトラック競技場へと広がる超ワイドショット

コメント