モーションビデオ制作とは？
Motion Video Productionは、初期計画から最終編集まで、30～90秒のモーショングラフィックスや動画の制作を導くClaude Codeのスキルです。動画生成を単一のプロンプトとして扱うのではなく、制作を6つのステージに分け、次の作業に進む前に各ステージの出力を検証します。
リポジトリにはharness/gate.pyのゲートスクリプトが含まれています。各ゲートは関連する成果物を測定して終了コードを返します。0はステージの合格、1は結果がブロックされ、修正が必要であることを示します。また、プロジェクトではreferences/gotchas.mdに、繰り返し発生する29件の制作上の問題をまとめています。
主な機能
- 6段階の制作ワークフロー：ストーリー計画、キャラクターデザイン、キーフレーム、動画クリップ、音声、最終編集。
- 測定可能な品質ゲート：各スクリプトがファイル、タイミング、フレーム数、アスペクト比、音声プロパティなど、ステージ固有の要件を確認します。
- 人によるレビューのチェックポイント：数値指標だけでは信頼性の高い判断ができない視覚的な問題を、人が確認して記録します。
- キャラクターの一貫性に関するガイダンス：7つの基準により、シーンの境界をまたいで外見、声、リップシンク、音楽とのタイミング、全体的な品質を維持します。
- フレームストリップ生成：クリップゲートが画像ストリップを作成し、冒頭フレームの後に発生するキャラクターの変化を明らかにします。
- 既知の問題に関するリファレンス：29件のGotchaで、症状、原因、予防手順、関連するハーネスのチェックIDを説明します。
- 再利用可能なテンプレートとスクリプト：リポジトリには、重複検出、ビートグリッド、クリップシート、音声ミキシング、mux、検証のための計画テンプレートとユーティリティが含まれています。
前提条件
Claude Code、Python 3、ffmpeg、ffprobeが必要です。
Remotionのコンポジションコードはこのリポジトリに含まれていません。Remotionを別途インストールし、自分のプロジェクトに必要なコンポジションを作成してください。
プロジェクトで言及されている任意の生成ツールには、画像や動画用のChatGPTまたはGrok Imagine、音楽用のSuno、音声用のElevenLabsまたはFish Audio、文字起こしベースのレビュー用のWhisperがあります。READMEには、verify.shのWhisper連携は未検証であると記載されています。
Claude Codeスキルをインストールする
Claude Codeは~/.claude/skills/<skill-name>/SKILL.mdでスキルを検出します。リポジトリをクローンし、skillsディレクトリを作成して、スキルフォルダ全体をコピーします。
git clone https://github.com/unclejobs-ai/motion-video-skill.git
mkdir -p ~/.claude/skills
cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/motion-video-productionディレクトリ全体をコピーする必要があります。ハーネス、リファレンス、スクリプト、テンプレートが連携して動作するためです。
1つのプロジェクトだけにインストールする
特定のプロジェクト内でのみスキルを利用できるようにする場合は、グローバルディレクトリではなく、そのプロジェクトの.claude/skills/ディレクトリに同じフォルダをコピーします。
mkdir -p your-video-project/.claude/skills
cp -r motion-video-skill/skills/motion-video-production \
your-video-project/.claude/skills/スキルをコピーした後、Claude Codeが新しいSKILL.mdを検出できるように再起動してください。
ハーネスを検証する
クローンしたリポジトリから、ハーネスのセルフテストを実行します。
bash skills/motion-video-production/harness/selftest.sh終了コード0は、現在のコンピューターでゲートハーネスが正常に動作することを確認します。テストに失敗した場合は、まずPython 3、ffmpeg、ffprobeがインストールされ、コマンドパスから利用できることを確認してください。
動画プロジェクトを開始する
Claude Codeを開き、制作したい動画を説明します。例えば、次のように入力します。
キャラクターが登場する30秒のオープニング動画を作りたいです。
制作開始前に、Claudeは4つの条件について質問します。
- 動画の公開または配信方法。
- 想定する長さとアスペクト比。
- 制作に利用できるツール。
- 結果に含めてはいけない要素。
これらの質問に回答すると、スキルはSTORY.mdから開始し、ステージを順番に進めます。
6段階のワークフローを理解する
ワークフローでは、STORY.md、character.txt、key/、clip/、voices.json、edit.jsonなどの成果物を作成します。各成果物は後続ステージへの入力となるため、出力が一見問題なさそうに見えるという理由だけでステージを省略しないでください。
1. ストーリーとシーンの計画
storyゲートは、未入力のフィールド、BPM情報、音楽同期テーブル内の数値形式の時刻、シーンテーブルを確認します。第2引数にプロジェクトディレクトリを指定して実行します。
python3 harness/gate.py story /path/to/video-project高コストなメディアを生成する前に、計画上のエラーを解消してください。特に、後続のカットがビートグリッドに従えるよう、音楽のタイミングとシーン構成を早い段階で確定します。
2. キャラクターシート
characterゲートは、character.txtがプレーンテキストの1つの段落であり、色の説明を含み、必要なキャラクターシート画像を伴っていることを確認します。
python3 harness/gate.py character /path/to/video-project固定された外観の説明とキャラクターシートは、後続のキーフレームやクリップで共通して参照する視覚資料となります。
3. キーフレーム
keyframesゲートは重複ファイルを検出し、クリップで想定されるアスペクト比を確認します。
python3 harness/gate.py keyframes /path/to/video-projectキーフレームは計画用の画像にとどまりません。生成される動画クリップの開始フレームとしても機能します。
4. 動画クリップ
clipsゲートは、長さ、フレーム数、クリップが想定されたキーフレームで始まっているかを確認します。また、フレームストリップを生成し、各クリップについて記録済みの判定を要求します。
python3 harness/gate.py clips /path/to/video-projectクリップが開始時点でキーフレームと一致していても、1～2秒後にキャラクターの服装、眼鏡、髪型、顔が変化することがあります。そのため、ゲートはキーフレームに加え、0、1.0、1.5、2.0、3.0秒時点のフレームを含むqa/strip-<clip>.pngファイルを作成します。
ストリップを開いて後半のフレームを確認し、結果をqa/clips-review.mdに記録してください。SSIMなどの類似度指標では、意図したキャラクターの動きと望ましくないキャラクターの変形を確実に区別できないため、後半のフレームには人による判断が必要です。
5. 音楽と音声
audioゲートは、プロジェクトで1つの音声IDが使用されていることと、必要な台詞ファイルが存在することを確認します。
python3 harness/gate.py audio /path/to/video-projectカットの長さを確定する前に、台詞の長さを測定してください。そうしないと、割り当てられたシーン内に台詞が自然に収まらない場合があります。
6. 編集と最終レビュー
最終段階ではeditゲートとfinalゲートの両方を使用します。これらのチェックでは、ビートグリッド、カットの接続、繰り返しカット、台詞の長さ、フレーム数、音声の有無、ラウドネス、トゥルーピーク、必要なレビュー記録を確認します。
python3 harness/gate.py edit /path/to/video-project
python3 harness/gate.py final /path/to/video-project完成した作品の視覚レビュー結果はqa/review.mdに記録する必要があります。自動測定でこのレビューを代替することはできません。
ゲートでブロックされた場合の対応
すべての段階で、同じ修正ループを使用します。
python3 harness/gate.py <stage> <project-directory>を実行します。- プロセスの終了コードを確認します。
- コードが
0なら、次の段階に進みます。 - コードが
1なら、qa/gate-<stage>.txtを開きます。 BLOCKと記された行を探します。- 対応する成果物を修正します。
- 合格するまで同じゲートを再実行します。
python3 harness/gate.py clips project | tailのようなパイプラインでコマンドを隠さないでください。パイプラインではゲートの終了ステータスが最後のコマンドのステータスに置き換わり、失敗したゲートが成功したように見えることがあります。
高度な制作のヒント
すべての継ぎ目でキャラクターの同一性を維持する
このプロジェクトでは、キャラクターシート、固定された外観の説明、キーフレームの開始画像、固定された音声、台詞とリップシンク、音楽のビートとの同期、品質レビューという7つの一貫性基準を定義しています。各基準が6段階のワークフローのどこに該当するかは、references/consistency-7.mdを参照してください。
任意の秒数ではなくビートからカットを作る
カットの長さは音楽のビートの倍数として選択します。累積したタイミングをフレームに変換する際は、個々のセグメントごとに繰り返し丸めるのではなく、累積時間から開始フレームを一度だけ丸めてください。これによりタイミングのずれが減り、落とし穴G11およびG12に関連する指針に従えます。
編集を確定する前に台詞を測定する
最終的なカットの長さを決める前に、台詞を生成または測定してください。この順序により、短すぎるシーンに台詞を無理に押し込むことを防ぎ、落とし穴G13にも対処できます。
信頼性の高いffprobe出力を使用する
ICCプロファイルを含む動画では、ffprobe -of csv=p=0が30,のようなフレーム数を出力することがあります。このプロジェクトでは、ラッパーやキーを付けないデフォルト出力を推奨しています。
ffprobe -of default=nw=1:nk=1 ...フィルタリング中の音声遅延を維持する
ffmpegの使用時に、adelayの後でapadとatrimを適用すると、意図した遅延が失われることがあります。この状況では、プロジェクトの落とし穴に関する指針に従い、asetpts=N/SR/TBを使用してください。
手探りでトラブルシューティングする前に付属のリファレンスを使う
段階が繰り返し失敗する場合や、生成されたメディアが予期せず変化する場合は、skills/motion-video-production/references/gotchas.mdを開いてください。そこにある29項目それぞれに、症状、考えられる原因、防止策、関連するハーネスチェックIDが記録されています。
知っておくべきリポジトリの構成要素
SKILL.mdにはClaude Codeのスキル指示が含まれています。harness/gate.pyは段階ごとの合格またはブロック判定を実行します。harness/selftest.shはハーネスのインストールを検証します。scripts/には、重複チェック、クリップシート生成、キープレート、ビートグリッド生成、ミキシング、mux、検証用のユーティリティが含まれています。templates/には、ストーリー、キャラクターシート、プロンプト、シーン監査用のテンプレートが含まれています。references/には、一貫性に関する指針、ビートグリッド情報、コストルール、ツールの注意事項、ライセンス情報、制作上の落とし穴が含まれています。NOTICE.mdには外部ツールに関する考慮事項がまとめられています。
ライセンスと責任
リポジトリ自体はMITライセンスを使用していますが、外部の生成ツールにはそれぞれ独自の料金、利用条件、商用ライセンス条件があります。NOTICE.mdとreferences/licensing.mdを確認し、料金やポリシーは変更される可能性があるため、本番環境で使用する前に必ず最新の条件を直接確認してください。生成されたアセットに関する責任は、これらの通知および外部の利用条件に従うものとします。
まとめ
Motion Video Productionは、短編動画の制作を再現性と検証性のあるワークフローに変えます。その主な価値は単一の生成ツールではなく、計画、キャラクターリファレンス、キーフレーム、クリップ、音声、最終編集をつなぐ、規律ある一連の工程にあります。ゲートの失敗を無視するのではなく修正作業として扱い、必要なビジュアルレビューを完了することで、完成動画に到達する前に連続性、タイミング、納品上の問題を発見できます。