mcpField
V
video-prompting

video-prompting

github.com/square-zero-labsクリエイティブ・メディア188614 回インストール4 日前に更新
リポジトリ

video-prompting について

video-promptingは、ユーザーの意図を動画モデル向けのプロンプト、または画像モデル向けのキャラクターシート用プロンプトにまとめるスキルです。モデルや入力モードに応じた手順と出力形式を案内します。

主な機能

  1. 01モデル別の動画プロンプトガイド
  2. 02キャラクターシート用プロンプト手順
  3. 03モデルと入力モードによる振り分け
  4. 04必要最小限の確認事項
  5. 05プロンプト形式と検証ルール

活用シーン

  1. 01指定した動画モデル向けプロンプトの作成
  2. 02再利用可能なキャラクター参照シートの作成
  3. 03画像を基準にした動画生成プロンプトの準備

インストール

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

$npx skills add https://github.com/square-zero-labs/video-prompting-skill --skill video-prompting

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/models/ltx2-3/
prompting.md
references/models/ltx2-5/
prompting.md
references/models/ltx2/
prompting.md
references/models/ltx2/example_prompts/
ltx2_examples.md
references/models/minimax-h3/
prompting.md
references/models/minimax-h3/example_prompts/
full_reference_performance_transfer.md
motion_graphics_trailer.md
references/models/ovi/
prompting.md
references/models/ovi/example_prompts/
gpt_examples_10s_i2v.csv
gpt_examples_10s_t2v.csv
gpt_examples_i2v.csv
gpt_examples_t2v.csv
references/models/seedance2-5/
prompting.md
references/models/seedance2/
prompting.md
references/models/seedance2/example_prompts/
seedance2_examples.md
references/models/veo3/
prompting.md
references/models/wan-animate-2/
prompting.md
references/models/wan22/
prompting.md
references/workflows/
character-sheets.md

詳細

動画プロンプト

概要

ユーザーの意図を、次のいずれかに変換します。

  • モデルに適合した質の高い動画プロンプト
  • 後で画像から動画を生成する際の一貫性を支える、キャラクターシート用の質の高い画像モデル向けプロンプト

モデル固有の動画ガイダンスは references/models/ にあります。キャラクターシートのガイダンスは references/workflows/character-sheets.md にあります。 このファイルは導入ページです。適切な手順に案内し、必要最小限の確認質問をしてから、想定される形式でプロンプトを作成します。

モデル一覧

  • Ovi:references/models/ovi/prompting.md
  • Veo 3 / 3.1:references/models/veo3/prompting.md
  • Wan 2.2:references/models/wan22/prompting.md
  • Wan Animate 2:references/models/wan-animate-2/prompting.md
  • Seedance 2.0:references/models/seedance2/prompting.md
  • Seedance 2.5:references/models/seedance2-5/prompting.md
  • MiniMax H3:references/models/minimax-h3/prompting.md
  • LTX-2:references/models/ltx2/prompting.md
  • LTX-2.3:references/models/ltx2-3/prompting.md
  • LTX-2.5:references/models/ltx2-5/prompting.md

ワークフロー一覧

  • 一貫性のあるキャラクターのキャラクターシート:references/workflows/character-sheets.md

後からモデルを追加するには、references/models/<model>/prompting.md を作成し、この一覧に追加します。

後からワークフローを追加するには、references/workflows/<workflow>.md を作成し、ワークフロー一覧に追加します。

動画プロンプトの共通ルール

以下のルールは、すべての動画モデルのリファレンスに適用されます。

  • 選択したモデルの必須プロンプトスキーマにタイミングが明示的に含まれている場合を除き、最終的なプロンプト文にはモデル名、モデルのバージョン、長さ、アスペクト比、解像度、API/制御パラメーター名を含めないでください。MiniMax H3 のアラインメント指示とショットのタイムスタンプは例外です。
  • それ以外の場合、長さはプロンプトで扱えるアクションの数を計画するための内部情報としてのみ使用します。
  • ユーザーがパラメーターを求める場合、またはモデルがパラメーターを必要とする場合は、プロンプトの外に、推奨パラメーターを別の行で提示してください。
  • 画像から動画を生成する場合は、画像を視覚的な基準として扱います。ユーザーが画像の分析を求める場合、または変更が必要な細部がある場合を除き、画像を詳しく描写しないでください。動き、カメラ、感情や演技、音声に重点を置いてください。

ワークフロー

ステップ 1 — リクエストを振り分ける

ユーザーが求めているものを判断します。

  • 動画生成プロンプト
  • 画像モデル向けのキャラクターシート用プロンプト

再利用可能なリファレンスシート、ターンアラウンド、表情シート、衣装シート、写真によるアイデンティティシート、または長めの画像から動画を生成するプロジェクトの出発点となる一貫性のあるキャラクターをユーザーが求めている場合は、キャラクターシートのワークフローに振り分けます。

両方を求めている場合は、次の順に進めます。

  1. キャラクターシート
  2. シーンの静止画/基準フレーム
  3. 動画プロンプト
ステップ 2 — 動画プロンプトの場合は、モデルと入力モードを特定します

ユーザーがモデル名を指定していない場合は、使用しているモデルを尋ねます(または、Model Index でサポートされている選択肢を提示します)。

次に、入力モードを確認します。まずテキストから動画を生成するモード(t2v)または画像から動画を生成するモード(i2v)を確認し、選択したモデルのガイドでサポートされている追加のキーフレームモードやフルリファレンスモードも使用します。

MiniMax H3 では、T2VA、I2VA、最初と最後のフレームから動画を生成するモード(FL2VA)、最後のフレームから動画を生成するモード(L2VA)、フルリファレンスモードを区別します。最終フレームの位置合わせやタイミング指定のカットに必要な場合は、実効時間を尋ねます。

Seedance 2.5 では、テキストから動画を生成するモード、画像から動画を生成するモード、リファレンスから動画を生成するモード、編集、延長を区別します。複数のビートで構成されるタイムラインが必要な場合は実効時間を尋ね、長いショットや連続性が重要なショットでは、意図する終了状態を尋ねます。すべてのリクエストでモデルの最大時間を既定値にするのではなく、動作に合う最短の時間を推奨します。

i2v の場合:ユーザーに画像の共有を依頼します(任意ですが、より適切なプロンプトを作成するのに役立ちます)。選択したモデルのガイダンスに従って画像をアンカーとして使用します(例:人物の同一性、衣装、構図を維持し、テキストでは動き、カメラ、変化する内容に重点を置きます)。

選択したモデルにバージョン、時間の制約、必須パラメーターがある場合は、適切な形式を選ぶために必要最小限の質問をします(モデルガイドを参照)。 LTX-2.3 では、時間の指定がない場合、外部の時間設定を既定で 10 秒とし、短くするか長くするかを尋ね、時間に合わせて動きの複雑さを調整します。プロンプト自体には時間を書きません。

LTX-2.5 では、連続した単一ショット、ネイティブのマルチショットシーン、脚本形式のセリフ、Dub-It による音声置換、Video Editing IC-LoRA を区別します。ユーザーが設定について尋ねた場合、固定の長さは必要なく、インターフェースが対応していれば、外部設定として自動時間を推奨します。最終フレーム条件付けを指定する場合は、外部の固定時間を使用します。プロンプト自体には時間や設定名を書きません。

ステップ 3 — 適切なリファレンスを読み込み、その形式に従います

動画プロンプトの場合:Model Index からモデルの prompting.md を開き、そのルールに厳密に従います。

キャラクターシートの場合:references/workflows/character-sheets.md を開き、その構成に厳密に従います。これは画像モデル向けのプロンプトとして扱い、動画モデル向けのプロンプトとしては扱いません。

ステップ 4 — 適切な形式でプロンプトを作成します

ステップ 3 で選択した Markdown ファイルの構成と制約に従って、プロンプトを作成します。

動画プロンプトの場合:セクションの推奨順序、セリフ/音声の形式、ショット構成に関するガイダンスを含め、選択したモデルの prompting.md に厳密に従います。 動画プロンプトを返す前に、選択したモデルのプロンプトスキーマで必要なタイミングを除き、モデル名/バージョン、クリップの長さ、アスペクト比、解像度、生成設定に関するプロンプト内の記述をすべて削除します。

キャラクターシートの場合:レイアウト、一貫性に関する制約、表情の行に関するガイダンスを含め、references/workflows/character-sheets.md に厳密に従います。

ステップ 5 — 出力

デフォルト:最終的なプロンプトのテキストのみを出力します。 デフォルトの書式:ユーザーが複数行の書式を明示的に求める場合、または選択したモデルのガイドで構造化された複数行スキーマが必須の場合を除き、プロンプトは改行なしの1行で出力します。MiniMax H3 は例外です。必須のフィールド名、行の順序、空行による区切りを維持してください。Seedance 2.5 も、複雑なタイミング指定や参照画像に基づくショットの場合は例外です。ガイドにある制作メモのセクションとタイムラインの改行を維持してください。LTX-2.5 では、セリフやビートの明瞭さに役立つ場合、脚本形式の複数行書式を維持してください。シングルショット、画像から動画への変換、マルチショットの説明文は、デフォルトで1つの段落にまとめてください。

ユーザーが選択肢を求めた場合:モデルの書式に準拠した、互いに異なる2~3種類のプロンプト案を、それぞれ単独で使用できる形で提示します。

モデルに必須の API パラメーター(例:duration/size)がある場合、ユーザーがそれらを指定したか、明示的に求めた場合に限り、「推奨パラメーター」の行を簡潔に記載します。

ユーザーが一貫性を保つワークフロー全体を求めた場合は、キャラクターシート用のプロンプトに加えて、以下も提示します。

  • キャラクターシートを参照して最初のシーンの静止画を作るプロンプト
  • 続きとなる画像から動画への変換ショット用のプロンプト

コメント