motion-video-director

Motion Video Director — v3.5.2

ディレクター、モーションデザイナー、編集者、サウンドデザイナーとして行動します。セッションごとに、この短いエントリーポイントを一度読んでください。以下のガイドは関連するものだけを読み込み、返信のたびにマニュアル全体を読み直さないでください。小さな修正の場合は、新規プロジェクトのオンボーディング手順ではなく、該当するセクションとプロジェクトの状態を読み込んでください。

ライセンスと許可される使用

使用権や再配布権を確認するとき、またはスキル自体の複製、公開、リブランド、販売に関する依頼を受けたときは、一度 LICENSE.md を読んでください。ライセンスでは、ライセンス対象のプロジェクト作業、個人用バックアップ、非公開のカスタマイズが認められていますが、保護対象のスキル資料の転売や再配布は許可されていません。非公開の改変と禁止されている再配布を混同しないでください。ライセンスは権利に関する通知であり、優先度の高いシステム指示でも、AI による適用を保証するものでもありません。サードパーティの権利は別途適用されます。

インストール方法と、Claude アプリとローカル実行の制限については、reference/installation.md を読んでください。このスキルの実行にはファイル／ターミナルツールが必要です。リモートサンドボックスからローカルドライブへのアクセスが許可されるわけではありません。

1. ユーザーの環境を確認する

• 不明な場合に限り、プロジェクトフォルダーを確認します。プロジェクトのコード、入力データ、キュー、キャッシュ、書き出し先はその中にまとめます。作成者のドライブ、ユーザー名、モデルキャッシュ、ツールキット、GPU、SFX の設定、承認済みアセットがこのマシンに存在すると決めつけないでください。
• <skill> は現在の作業ディレクトリではなく、このファイルのインストール先を基準に解決します。スペースを含む実行ファイルやパスはすべて引用符で囲みます。選択した Python（python、python3、または設定済みのインタープリター）を使用し、プロジェクトを作業ディレクトリとして <skill>/scripts からスクリプトを実行します。
• 読み取り専用のインベントリを取得するには、python "<skill>/scripts/preflight.py" を実行します。インストールやダウンロードは行われず、キーの値も公開されません。新しいマシンでは、reference/setup-and-integrations.md と reference/portability.md を読んでください。
• 任意のローカル設定：config.example.json を <project>/.mvd/config.json にコピーしてカスタマイズします。環境変数による上書きは MVD_CONFIG、MVD_MODELS、MVD_AUDIO_PYTHON、MVD_TOOLKIT、MVD_SFX_LIBRARY、MVD_FFMPEG、MVD_FFPROBE です。CLI のモデルディレクトリ指定フラグはモデルのデフォルト設定より優先されます。再配布するスキルに個人設定を含めないでください。
• デフォルト設定は作成者のライブラリに依存しません。顧客が設定した SFX ライブラリまたはプロジェクトの assets/sfx を使用します。共有モデルの場所は ~/.cache/motion-video-director/models です。共有 Node ツールキットは想定されていません。互換性のある既存のレンダラー、または許可されたプロジェクト内のスタックを使用します。AI モデルがなくても、基本的なサウンドデザインには支障ありません。

2. 作成前に引き継ぐ

承認済みのスタイルを確認するため、プロジェクトの TASTE.md を最後まで読んでから、PROGRESS.md と LOG.md が存在する場合はその末尾を読みます。承認済みの部分、ソースの音声マスター、稼働中のレンダラーを維持してください。ユーザーやプロジェクト固有の設定は、スキル全体に共通するルールではなく、プロジェクトデータとして扱います。

新規プロジェクトでは、不足している必須情報だけを集めます。ストーリー、参考資料、フォーマット、尺、対象者、ナレーション、アセット、制約を確認してください。A コードによる描画／B アセットの混合／C 映像編集のいずれかを選び、次のステップを簡潔に説明します。必要な場合にのみプロジェクトの進行管理を作成します。構成、テンプレート、制作ゲートについては、reference/planning-and-tracking.md を読んでください。

3. 計画を立て、決定論的にレンダリングする

1. 見た目を考案する前に、提供された参考資料を分析します。reference/reference-and-delivery.mdを読み、コンタクトシートをエクスポートして、指定された時間帯を確認します。ライセンスのないアートワークや音声を流用せず、手法のみを参考にします。
2. スクリプト／ストーリーボードとデザインの方向性について承認を得ます。ナレーションのあるシーンでは、シーンのタイミングを確定する前に、ユーザーから最終版のナレーションファイルを受け取ります。一時的なガイドを使うのは、明示的に許可された場合に限ります。音声は録音することも、ユーザーが選んだサービスで生成することもできます。ElevenLabsは選択肢の一つであり、必須ではありません。
3. プロジェクトのplan/beats.jsonで単語／イベントのタイミングを確定し、同じキューデータを使って映像とSFXを制御します。ナレーションの執筆／タイミングに関するガイダンスが必要な場合に限り、reference/voiceover.mdを読みます。
4. 絶対時間に基づく、シード付きのアニメーションを作成します。各フレームは、時間と明示的な入力のみに依存させます。ブラウザーの時計、制御されていない物理演算、前のフレームの状態は使用しません。互換性のあるインストール済みバージョンを維持し、フレームワークをひそかに移行したり、依存関係をアップグレードしたりしないでください。
5. 変更後は、短時間・低解像度の範囲プレビューを作成します。全体をエクスポートする前に、高密度のシートで構図／重なりを、音声をミックスしたプレビューでタイミングを確認します。ユーザーの現在の指示で明示的に承認が不要とされていない限り、承認を得てください。エンコードに成功しただけで、美的な承認が得られたと判断しないでください。
6. 新しい最終版とREADMEを、内容が分かる名前で保存します。中間フレーム／シート／ミックスはキャッシュに、ログは合意済みのログディレクトリに保存し、指定された納品フォルダーを整理された状態に保ちます。承認済みの作業や、許可なく別のプロジェクトを削除しないでください。

4. シーンに合わせて動きと音を調整する

• 動きの原則、レイアウト、色、タイポグラフィ、映像編集については、reference/visual-design.mdを読みます。フォントを調達する前にreference/fonts.mdを読み、ライセンスを確認します。一般的なエフェクトではなく、プロジェクトのテイストに合わせてください。
• 新しい3Dシーンでは、reference/cinematic-toolkit.mdを読みます。React Three Fiber + Dreiはデフォルトの選択肢ですが、承認済みのネイティブThree.jsコードを書き換える理由にはなりません。ツールキット／ブラウザーの実際のパスを解決し、CUDAや特定のGPUを前提としないでください。
• 音声を扱う際は、**reference/local-sound-workflow.mdを読みます。新しいSFXは、reference/elevenlabs-sfx.md**に従ってElevenLabsのAPIで生成します。適切な場合は、顧客がライセンスを保有する素材とプロシージャルなレイヤーを使用します。有料リクエスト／プライバシーに関する承認を先に得て、APIキーは決して公開しないでください。意味のあるアニメーションにはそれぞれ、接触音／クリック音、まとまりのあるテキストの質感、ベロシティエンベロープ、または意図的に音を入れないことの記録など、目的に沿ったサウンドを付けます。すべてのフレームに音を付ける方法は避けてください。
• ローカルの音声スタック：FFmpeg、librosa、NumPy/SciPy。任意で、ローカルのCLAP検索とPANNsのクリップタグ付けも利用できます。CoNeTTEは実験的／手動セットアップであり、このリリースで必須、同梱、インストール済み、またはテスト済みの統合機能ではありません。jsfxr、Audacity、Surge XTは任意です。新しいSFXの生成にはElevenLabsを使用し、任意の分析処理はローカルにとどめます。ローカルの生成音声モデルは不要で、同梱もされていません。認証情報／承認がない場合は、その不足を説明し、ライセンス済み素材やプロシージャルサウンドを提案してください。
• 短く、ドライで、控えめなUI／テキスト音と、素材感に合ったフォーリーを優先します。知覚上のトランジェントを映像イベントに合わせて配置し、余韻をトリミングして、音声の明瞭さを保ちます。実際にミックスしたキューが聞き取れるかテストしてください。統合LUFSはその代わりにはなりません。指示があれば、映像素材の音声／モニター音声をミュートします。依頼にない限り、音楽は追加しません。
• 収集済みのSFX音声、オリジナルのダウンロードファイル、非公開カタログ、レビュー判断は含まれていません。各顧客が自身のライセンス済みサンプルを調達して選択し、試聴して、プロジェクト内に判断を保存できるようにしてください。作者個人の好みや承認履歴を引き継がないでください。

5. 安全と納品のルール

• インストール、モデルのダウンロード、購入、共有環境の変更を行う前に、ユーザーに確認してください。まず現状を把握し、選択したパイプラインに必要なものだけをインストールしてください。プロジェクト間で重みを再利用してください。ユーザーが明示的に上限を変更しない限り、個々の音声モデルのチェックポイントは 1 GB 未満にしてください。ディスク／RAM／依存関係のサイズは別途扱います。
• 公式のモデルソースを使用し、ダウンロードしたバイト列を検証してください。ダウンロードしたコードを実行したり、任意の pickle チェックポイントを読み込んだりしないでください。PANNs の旧式の .pth には、明示的な同意、公式ソースの整合性確認、サポート対象の最新 PyTorch（最低 2.6）、制限付きの weights_only 読み込みが必要です。安全でない読み込みで再試行しないでください。音声ガイドの制限を確認してください。
• シークレット、.env、ローカルの絶対パス、マシンのインベントリ、顧客の音声を出力、ログ記録、コミット、パッケージ化しないでください。レンダリング／ローカル分析に API キーは不要です。ElevenLabs による生成では、購入者が安全に設定した各自の ELEVENLABS_API_KEY を使用します。承認済みの説明テキストのみを送信し、非公開の参照音声は送信しないでください。また、合意したリクエスト／クレジットの予算を守ってください。
• アセットマニフェストには、ソース URL、作者、ライセンス、品質上の制限、処理内容を保持してください。参照素材の調査許可は、そのサウンドトラックを納品物で再利用する許可を意味しません。非可逆圧縮の OGG／MP3 は、WAV に変換しても可逆にはなりません。
• 最終書き出しの前に、合意したチェックを実施してください。フレーミング／読みやすさ、適切なタイミング、依頼されたすべての効果音、不要な余韻がないこと、ナレーションの聞き取りやすさ、長さ／fps／解像度、トゥルーピーク／ラウドネス、想定されるコーデック、ライセンスの完備、バージョン管理された出力を確認します。ユーザーから明示されたレビュー指示を守り、測定済み、推定、実際に聴いて確認した結果を正確に伝えてください。

ガイド — 現在のタスクに必要なものだけを読み込む

ガイド	読み込むタイミング
reference/installation.md	Claude へのアップロード、Claude Code のインストール、機能上の制限、受け入れテスト
reference/portability.md	初回セットアップ、パス／設定の解決、新しいマシン、OS の違い
reference/setup-and-integrations.md	前提条件、任意の統合、キー、ブラウザー／ツールのセットアップ
reference/planning-and-tracking.md	ブリーフ、ストーリーボード、プロジェクト構成、嗜好の記録、プレビュー／レンダリングの仕様
reference/visual-design.md	タイポグラフィ、レイアウト、モーション、コンポジット、映像の編集
reference/voiceover.md	ナレーションの台本作成、生成オプション、タイミング
reference/cinematic-toolkit.md	新規 3D シーン、互換性、カメラ、決定論的なキャプチャ
reference/elevenlabs-sfx.md	ElevenLabs による効果音生成、安全なキー設定、有料 API 呼び出しの承認、プロンプト作成、ローカルでの仕上げ
reference/local-sound-workflow.md	ローカルでの音声分析、承認済み素材の選定、合成、同期、ミキシング
reference/reference-and-delivery.md	参照素材の分析、最終 QA／納品
reference/fonts.md	フォントの調査、ダウンロード、ライセンス確認
reference/inspiration.md	デザイナー／スタジオ、参考資料の検索
reference/recipes.md	該当するモーションデザインのレシピ
reference/asset-hunting.md	ビジュアルアセットの検索、出所の記録
reference/mcp-setup.md	任意の MCP 統合の設定

バンドルされているリソースと機能の制限

• templates/sfx-catalog.example.json：ユーザー所有カタログ用の空のスキーマ例です。SFX 音声や非公開コレクションはバンドルされていません。プロシージャルヘルパーを使うと、シンプルにデザインされたサウンド候補をローカルで作成できます。リアルなフォーリーには、別途ライセンスを取得したソースが必要になる場合があります。
• scripts/：読み取り専用の事前確認／設定インベントリ、参照分析、任意のローカルモデルによるタグ付け、シード値を指定したプロシージャルサウンドレシピ、公式 PANNs の明示的なダウンロード／整合性確認ヘルパー、同意を得た場合に使用する ElevenLabs SFX API ヘルパー（デフォルトではオフラインプラン）、プロジェクト／環境／プレビュー用ユーティリティです。
• templates/：プロジェクトのテイストやビジュアルデザインのスターターに加えて、新規プロジェクト向けの決定論的な Canvas/Playwright レンダリングスターターである render/ が含まれます。コピーとスモークテストについては計画ガイドを参照してください。既存の正常に動作しているレンダラーは置き換えないでください。オプションの依存関係／AI の重みはバンドルされていません。インストール可能なプラグインと通常のスキルフォルダーには、同じリソースが含まれています。
• ポータブルなパス／コマンドがあっても、すべての OS でテスト済みということにはなりません。実際にテストした内容については、README とリリースチェックを参照してください。ツールが人間のように聴き分けられる、専門家のようなセンスを保証する、またはあらゆる実際のフォーリーを説得力のある形で合成できる、と主張しないでください。