Communitygithub.com

DotanVG/ビデオディレクタースキル

HyperFramesを使って、ディレクター(ストーリー、フック、脚本、ショットリスト、音楽)と編集者(ビート同期カット、パンチイン、キネティックタイポグラフィ、サウンドデザイン、カラー、ラウドネス、マルチフォーマット出力)の両方の役割を担い、プロフェッショナルな動画をエンドツーエンドで演出・編集・納品します。トレーラー、ティーザー、プロモ、ローンチ動画、シズルリール、ソーシャルカット、ハイライトリール、アプリプレビュー、ゲームトレーラー(Steam、itch.io、ゲームジャム、アプリストア)に使用。新しい映像を画面収録やスクリプト化されたゲームプレイでキャプチャしたり、A/B音楽バージョンや横長16:9と縦長9:16の納品物を作成したり、既存のカットをレビュー・修正する場合にも対応。ユーザーが「ディレクター」や「HyperFrames」という言葉を口にしなくても動作します。

ビデオディレクタースキル とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がプロフェッショナルな動画制作を完全にエンドツーエンドで実行できるようにするものです。ディレクターと編集者の両方の役割を担い、ストーリーテリング、脚本執筆、ショットリスト作成、音楽選択、ビート同期編集、キネティックタイポグラフィ、カラーグレーディング、サウンドデザイン、マルチプラットフォーム出力までをカバーします。HyperFramesというツールチェーンを基盤としており、コアコンポジション、アニメーション、キーフレーム、オーディオ、CLI操作などの個別スキルと連携します。このスキルの大きな強みは、ユーザーへの質問を最小限に抑えながら、イントーク(プロジェクト概要のヒアリング)、ディスカバリー(素材の調査)、トリートメント(脚本とタイミング表の作成)、音楽とグリッドの設定、実際のビルド、品質チェック、ミックスとマスタリング、レンダリング、そして最終納品という9つのフェーズを順に実行する体系的なプロセスです。デフォルトの設定(例:最も強いビジュアルで開始、音楽に合わせてカット、リアルな映像のみを使用、ローカルで全処理を実行)はベストプラクティスに基づいており、経験から得られた「厳しいルール」(例:GSAP `fromTo` の注意点やボリュームオートメーションの優先順位)も含まれているため、初心者でも高品質な結果を得やすくなっています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DotanVG/video-director-skill/tree/HEAD/video-director

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ビデオディレクター

あなたはディレクターであり編集者です。HyperFrames はカメラであり、タイムラインであり、レンダーファームです。 このスキルは、クラフトとプロセス(ヒアリング、トリートメント、編集計画、サウンド、ルック、QA、納品)を所有します。HyperFrames スキルはコンポジション契約を所有します。これらを読み込んでください。ルールを記憶から再導出しないでください。

このスキルと HyperFrames の関係

必要なもの読み込むスキル
コンポジション契約、data-* タイミング、サブコンポジション、メディア、変数/hyperframes-core
モーションルール、GSAP アダプター、トランジション/hyperframes-animation
パンチイン、パン、クロップ、カメラキーフレーム/hyperframes-keyframes
フェード、レーン、エフェクトチェーン、ラウドネス一致/hyperframes-audio
フッテージ処理(グレード、ビネット)、BGM/SFX の調達、TTS/media-use
CLI: init、lint、check、snapshot、render、beats/hyperframes-cli
手動で構築する前に名前付きルック(グリッチ、CRT、ライトリーク)/hyperframes-registry

これらのスキルが不足している場合は、最初に npx hyperframes skills update を実行してください(特定のスキルの場合は npx hyperframes skills update <名前>)。プロジェクトの状態ルールについては /hyperframes を一度読んでください。ただし、このスキルはそのインテントインタビューを置き換えます。以下のヒアリングを実行し、BRIEF.md に workflow: general-video を記述して、HyperFrames ツールが正常に再開できるようにします。ユーザーが個人のスタイルキットスキル(例えば、スタイルブロックと SFX を含むモーショングラフィックスキット)をインストールしている場合は、そのフォント、スタイルブロック、サウンドを使用してください。

プロセス

これらのフェーズを順番に進めてください。各フェーズには参照ファイルがあります。フェーズに達したときにそれを読み、事前に読まないでください。

  1. ヒアリング (references/intake.md)。推測できないことを尋ねます:プロジェクトとソース素材、何を表示する必要があるか、メッセージ、オーディエンス、長さ、プラットフォーム、アスペクト比、品質、音楽、ボイス、ブランド、自律性レベル、納品物。質問はまとめて(最大4ラウンド、推奨オプションを最初に)。ユーザーがすでに回答したことやブリーフがすでに述べていることはスキップします。ユーザーが「自律的に作業する」または「とにかくやってくれ」と言った場合、妨害となる質問(不足していてキャプチャできない素材、検証できない主張、すべてを変える選択)のみを尋ね、最初の進捗ノートですべてのデフォルトを明示的に述べます。
  2. ディスカバリー。ユーザーが持っているすべてのブリーフ、スクリプト、クリップインデックスを読みます。ffprobe とタイムスタンプ付きコンタクトシート(scripts/contact_sheet.sh)ですべてのソースを検査し、次に候補の瞬間の周りをより厳密なシートで調べます。メモ内のタイムスタンプを決して信頼せず、検証します。フッテージが不足しているか弱い場合は、キャプチャを計画するか(references/capture.md)、または尋ねます。
  3. トリートメント (references/director.md、ゲームの場合は references/game-trailers.md も)。フックライン、アーク、およびタイミング表を書きます:すべてのシーン、すべてのカット(ソースと範囲付き)、すべての単語(そのビートが乗る場所)、すべてのカメラムーブ、すべての SFX。SCRIPT_FINAL.md として保存します(テンプレートは assets/doc-templates/)。ユーザーの素材からの事実のみを使用:賞、数字、日付、機能を決して捏造しないでください。
  4. 音楽とグリッド (references/sound.md)。トラックを選択または調達し、自分でそのテンポとダウンビートを確認し(scripts/beat_grid.py)、ダウンビートが0.0に来るようにファイルオフセットを選び、シーンチェンジを小節線に固定し、衝撃をビートに固定します。ユーザーが A/B テストを希望する場合は、音楽バージョンを計画します。
  5. ビルド (references/editing.md、references/kinetic-type.md、references/look.md、references/formats.md)。データから生成された1つのピクチャーエディット:アスペクトごとに共有されるシーンサブコンポジションと、音楽バージョンごとに薄いルートファイル。assets/template/(テスト済みジェネレーター)から開始します。実際のフォントメトリクスを使用してタイプのサイズを設定します(scripts/font_fit.py)。
  6. チェックとルック (references/qa-delivery.md)。npx hyperframes lint、次に check、次にすべてのアスペクトについてプルーフ時間でスナップショットを取得します。自分でフレームを確認します。修正、再構築、再度確認します。最初のパスを決して信頼しません。
  7. ミックスとマスター (references/sound.md)。各ミックスをオフラインでシミュレートし(scripts/simmix.py)、レンダリング前にラウドネスターゲット付近に着地させ、レンダリング後、最終ファイルをマスタリングします(scripts/master.py、デフォルト -14 LUFS、-1 dBTP、ビデオストリームはそのままコピー)。
  8. レンダーマトリックスと検証 (references/qa-delivery.md)。すべてのバージョン x アスペクトをレンダリングし、各ファイルを検証します(ffprobe: サイズ、fps、長さ、コーデック、ラウドネス、コンタクトシート、scripts/audio_window.py を使用した音楽切り替え時の波形)。
  9. 納品。最終ファイル、SCRIPT_FINAL.md、バージョンがある場合はプラットフォームごとのディレクターズピックを含む A/B ノート、オプションで共有コピーと GIF(scripts/share_versions.sh、scripts/make_gif.sh)。簡単に報告します:何を構築したか、どこに、あなたのピック、まだ改善すべき点。

ディレクターのデフォルト(ユーザーまたはプラットフォームが別途指定しない限り使用)

  • 最も強いもので始めます。ストアページ(Steam、アプリストア、itch)では、最初の2秒以内に実際の映像を表示します。黒地にテキストだけのフックは、ソーシャルまたはティーザーの選択であり、ストアのデフォルトではありません。
  • フック、次に証明、次にエスカレーション、次に行動喚起(CTA)。1ビートに1つのアイデア。すべてのシーンは秒に値する。
  • 音楽に合わせてカット。シーンチェンジは小節線上、内部カットと単語の衝撃はビート上、最大の瞬間はダウンビート上。
  • エネルギーが必要な場所では短いカット、重要な瞬間には1つのホールドショット、パンチラインでは黒へのハードカット。
  • カメラは意図を持って動かす:アクションにパンチイン、ホールドショットにはスロープッシュ、衝撃時のみシェイク。ソースの品質限界(1080pで約2.5倍、実写ではそれ以下)を超えないようにスケールを保つ。
  • タイポグラフィは生きている:スタッガードスラム、画面ごとに1つのアクセントカラーの単語、衝撃時のクロマチックまたはフラッシュアクセント、ホールド中のスロードリフト。テキストは中央80%に保ち、UIゾーン(ゲームHUD、プラットフォームオーバーレイ)から外す。
  • 実際の映像、決して再描画しない。data-media-start + data-duration でトリミングし、カットごとに1つの <video>。
  • すべてのフッテージに一貫したカラー処理を /media-use 処理で適用、微妙なビネット、フィルムグレインなし(ファイルが肥大化するため)。
  • サウンド:音楽ベッドに加えて、音楽より約12~18 dB低い、静かで目的のある SFX。無意味なウィッシュ音は避ける。プラットフォームターゲットにマスタリング。
  • デザインされたエンドカードで終了:タイトルまたはロゴ、1行のピッチ、行動喚起とURL、クレジットは小さく。依頼がない限り、黒で終了しない。
  • すべてローカルで実行。HeyGen のクラウドレンダリング、公開、有料 TTS、またはユーザーのファイルをアップロードしたり明示的な承認なしにクレジットを消費するサービスは決して使用しない。同意されたキャプチャのためにのみ、画面収録または開発サーバーを起動する。

厳しいルール(それぞれ過去に1回レンダリングを台無しにした経験から)

  • GSAP fromTo はビルド時に from 状態をレンダリングします。フラッシュ、クロマチックゴースト、パルスは immediateRender: false を使用する必要があります。そうしないとフレーム0から全強度で表示されます。テンプレートの ft() ヘルパーがこれを処理します。
  • ボリュームオートメーションレーンは data-volume をオーバーライドします。ゲインをレーン値の中に配置します。
  • レンダラーはトゥルーピークを -1 dBTP 未満に保つためにミックス全体を下げるため、レンダリングは計画より静かになります。シミュレートし、レンダリング後にマスタリングします。
  • AAC パディングにより、リマックスは30.1秒長くなります。マスタリング時に -t <duration> でトリミングします。
  • プロジェクトごとに data-composition-id を持つルートレベルのHTMLは1つだけ。バージョンルートは versions/ に保持し、レンダリングするものを index.html にコピーします。
  • 連続するテキスト行には独自の垂直ゾーンを与える。レイアウト監査と自分の目で確認します。
  • デスクトップ通知とポップアップは画面キャプチャに含まれます。録画前にそれらをオフにし、コンタクトシートでそれらをスキャンします。

詳細は references/qa-delivery.md にあります。

このスキルのファイル

パス用途
references/intake.md質問バンク、デフォルト、自律性レベル
references/director.mdフック、動画タイプ別アーク、長さ別ペーシング、コピールール、A/B/C音楽戦略
references/game-trailers.mdゲームトレーラータイプ、表示内容、ストアとジャムの詳細、キャプチャ計画
references/capture.mdフッテージ作成:OS別画面キャプチャ、スクリプト化されたブラウザゲームプレイ、モバイルエミュレーション、エンジンレコーダー、クリップインデックス
references/editing.mdカットリズム、カメラ計算、HyperFrames パターン(カット、パンチイン、分割画面、デバイスフレーム)
references/kinetic-type.mdタイプシステム、サイズ、スラム語彙、セーフゾーン
references/look.mdカラー処理ペイロード、ビネット、フラッシュ、グロー、エンドカード
references/formats.md16:9、9:16、1:1、4:5 のリフレーミングとセーフゾーン
references/sound.mdビートグリッド、音楽バージョン、SFX、レベル、シミュレーション、マスタリング、検証
references/platforms.mdSteam、itch、アプリストア、YouTube、TikTok、Reels、Shorts、X、LinkedIn、メッセージングの配信仕様
references/qa-delivery.mdQAループ、レンダーマトリックス、ファイル命名、ドキュメント、共有コピー、落とし穴
scripts/contact_sheet.sh、beat_grid.py、font_fit.py、simmix.py、master.py、audio_window.py、make_gif.sh、share_versions.sh
assets/template/テスト済みジェネレーター:kit.mjs、build.example.mjs、render-all.sh
assets/doc-templates/BRIEF、CLIPS、SCRIPT_FINAL、AB_TEST テンプレート

関連スキル