media-use: オーディオ/画像のソーシングを始める前に、
/media-useを呼び出してHeyGenカタログからBGM/効果音/画像を解決してください。まず--adoptを実行して既存のアセットを登録します。詳しくは/media-useスキルを参照してください。
Webサイト to HyperFrames
Webサイトをキャプチャし、そこからプロフェッショナルな動画を生成します。
ステップ0の前にルートを確認してください。 このスキルは、一般的なサイトの動画を作成します。ユーザーが実際に製品のマーケティング/ローンチ/プロモーションを目的としている場合(たとえそのURLからであっても、"自社サイトのプロモーション"であっても)→
/product-launch-video。サイトがないトピック解説動画 →/faceless-explainer。GitHub PR →/pr-to-video。既存の動画ファイルの再編集/色調変更/並び替え → 対象外。曖昧な「動画を作って」というリクエスト、またはローンチと一般サイトのどちらか不明な場合?まず/hyperframesを読んでください(完全なルーティングテーブル + 「HyperFramesができないこと」の節を含む)。
ユーザーからは次のような発言が想定されます:
- 「このWebサイトをInstagram用の15秒ソーシャルクリップにして」
- 「https://... から30秒のサイトツアー/ショーケース動画を作って」
- 「トップページをキャプチャして、そのビジュアルから動画をビルドして」
ワークフローは7つのステップで構成されています。各ステップは次のステップへのゲートとなるアーティファクトを生成します。デフォルトでは協調モードで動作し、💬 マークのゲートではユーザーに確認して停止します。ユーザーが自律モードを指定した場合(「決めて」「驚かせて」など)、💬 ユーザー設定ゲートはスキップされます。この振る舞いの詳細は step-2-brief.md を参照してください。
自律モードは「すべてのゲートをスキップする」ことを意味しません。 自律モードはユーザー設定に関する質問(TTSプロバイダー、音声、強調色、ビート数、音楽の有無、キャプションの有無など、エージェントがユーザーに代わって決定するもの)をカバーします。品質検証ゲートはカバーしません。以下の項目は自律モードでもスキップ不可です:
- アセット監査(ステップ3) — コンタクトシートを確認し、各アセットのUSE/SKIPを判断すること
- ビートごとのHTML読み取り(ステップ5) — ビートごとの構造化エビデンスブロック
- DoDチェックリスト(ステップ6) — アニメーションマップ、警告ごとのWCAG検証、オーディオ/モーション再生を含む
- 正直な開示セクション(ステップ6) — 最終サマリーに「確認しなかったこと」を含めること
もし「自律モードは行動に偏るから、Xをスキップしよう」と考える場合、Xが設定質問ではなく検証ゲートであれば、その推論は誤りです。「行動への偏り」は「何を構築するか」を決めることに適用され、「検証するかどうか」を決めることには適用されません。
ステップ 0: キャプチャとブランドの理解
読む: references/step-0-capture.md
サイトをキャプチャし、抽出されたデータを読んでブランドと製品を理解します — 何をするのか、誰のためのものか、どんな声で語るのか、どんな雰囲気なのか。キャプチャしたアセットは後で使うブランドツールキットであり、動画の構成要素そのものではありません。
ブリーフィングの前にサインイン状況を表示 — npx hyperframes auth status を実行し、その出力をそのまま伝えてください(言い換えたり書き換えたりしないでください)。 このコマンドは、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法を報告します。サインインしていない場合は、STOPしてユーザーの選択を待ってください — サインインするか、「go」/「offline」と言ってローカルエンジンで続行するか — ブリーフィングやその他の質問の前に。 これを単なる通過点ではなく、実際の決定ポイントとして扱ってください。選択肢をブリーフィングの質問に含めたり、リポジトリごとの .env ファイルにキーを書き込んだりしないでください。(自律モードでは、ステータスを記録してオフラインで続行します。)詳しくは ../hyperframes-media → Preflight の正式なガイダンスを参照してください。
ゲート: サイトサマリーが印刷されていること — アセット/カラー/フォントのインベントリの前に、戦略優先(製品の機能、対象ユーザー、ブランドの声)で記述されていること。サインイン状況が表示されていること(サインイン済み、またはオフラインで続行)。
ステップ 1: ブランドアイデンティティ
読む: references/step-1-design.md
DESIGN.md を作成します — ビジュアルアイデンティティ(カラー、タイポグラフィ、コンポーネントスタイル、レイアウト原則)をカバーするブランドチートシート。正確な計算値には design-styles.json を使用します。
速度オプション: テンポの速い動画(ビートごとにビルボード)の場合、DESIGN.md は 300行の文書ではなく、カラー+フォント+Do's/Don'ts の50行サマリーで構いません。ステップ5のサブエージェントプロンプトがブランド値を直接貼り付けるため、DESIGN.md の深さは複雑なコンポジションの場合にのみ重要です。
ゲート: DESIGN.md が存在すること(任意の長さ)。最低限、カラーパレット、フォントの選択、Do's/Don'ts を含むこと。
ステップ 2: 戦略とメッセージング
読む: references/step-2-brief.md, references/capabilities.md(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)
ビジュアルやアセットの話をする前に、動画が伝えるべきことについてユーザーと合意します。ユーザーのプロンプトを解析します — おそらくすでに動画のタイプとスタイルを指定しているはずです。不足しているものだけを質問します: この動画が唯一伝えるべきメッセージ、ナラティブアーク、そしてターゲットオーディエンス。
ゲート: 動画タイプ、尺、フォーマット、そして特にメッセージとナラティブアークが確定していること。これらがなければ、ステップ3でコンセプトファーストのストーリーボードを作成できません。
ステップ 3: ストーリーボード + 脚本 💬
読む: references/step-3-storyboard.md
コンセプトファーストでストーリーボードを作成: メッセージ → ナラティブアーク → アークを支えるビート → ビートごとのテクニック → 最後にブランドアクセントを追加。次に、それに合わせてナレーション脚本を書きます。両方をビートごとのサマリーとともにユーザーに提示します。承認されるまで反復します。
ゲート: STORYBOARD.md + SCRIPT.md が存在し、かつユーザーが計画を承認していること。
ステップ 4: VO、タイミング + キャプション 💬
ステップ2でナレーションなしと指定された場合 — 背景音楽について質問し、ステップ5にスキップします。それ以外の場合: ユーザーにTTSプロバイダー(HeyGen TTS、ElevenLabs、またはKokoro)を尋ね、オーディオを生成し、文字起こしをし、タイムスタンプをビートにマッピングします。次にキャプションについて尋ねます。
ゲート: (a) ナレーションが要求されず、ストーリーボードに手動のビートタイミングがある、または (b) narration.wav + transcript.json が存在し、ビートタイミングが実際の尺で更新されていること。
ステップ 5: コンポジションのビルド
読む: hyperframes スキル(読み込むこと — すべてのルールが重要)
読む: references/step-5-build.md
ストーリーボード(ステップ3)で選択されたアーキテクチャとペースに従って、index.html とコンポジションをビルドします。サブエージェントは各ビートについて hyperframes lint と hyperframes snapshot を実行してから報告します。
ゲート: すべての compositions/beat-N.html がメインエージェントによって DESIGN.md と STORYBOARD.md に対して最初から最後まで読み取られていること。ビートごとのチェックリストは step-5-build.md にあります。
ステップ 6: 検証と納品
読む: references/step-6-validate.md
Lint、検証、動画の尺に応じたスナップショットの撮影(計算式: max(beats × 3, ceil(duration_seconds / 2)))、そしてそれぞれをレビューします。問題を修正してから納品します。ローカルホストのStudioプロジェクトURLを納品します — MP4へのレンダリングは明示的なユーザー要求があった場合のみ行います。Studio URL は引き渡しの時だけ表示します — それが最終的な安定したプレビューです。ビルドフェーズのスナップショットはヘッドレスなので、ビルド途中でプレビューを表示しないでください。
自信を持って納品してください。 引き渡す前に自問してください: これを自分の名前でソーシャルメディアに投稿しますか? もし違うなら、問題を修正してください。
ゲート: npx hyperframes lint と npx hyperframes validate がエラーゼロでパスし、最終応答にアクティブなStudioプロジェクトURLが含まれていること。
クイックリファレンス
動画タイプ
動画タイプごとの典型的な制約 — 公式ではなく出発点として使用してください。ビート数はコンテンツとナレーションに従うべきであり、目標範囲から決めるべきではありません。
| タイプ | 典型的な尺 | 尺の決定要因 | ナレーション |
|---|---|---|---|
| ソーシャル広告 (IG/TikTok) | 10–15秒 | プラットフォーム制限 | 任意 |
| 製品デモ | 30–60秒 | 脚本の長さ | フルナレーション |
| 機能告知 | 15–30秒 | 機能の複雑さ | フルナレーション |
| ブランドリール | 20–45秒 | 音楽トラック | 任意、音楽重視 |
| ローンチティーザー | 10–20秒 | フックのエネルギー | 最小限 |
ビート数は意図的にこの表に含めていません — ストーリーボードから決めるべきであり、「ソーシャル広告 = 3-4ビート」から決めるべきではありません。複雑な製品のソーシャル広告には、タイミングの良い5ビートが必要かもしれません。1つの強力なビジュアルテーマを持つブランドリールには3ビートで十分かもしれません。
フォーマット
- ランドスケープ: 1920x1080(デフォルト)
- ポートレート: 1080x1920(Instagram Stories、TikTok)
- スクエア: 1080x1080(Instagramフィード)
リファレンスファイル
| ファイル | 読むタイミング |
|---|---|
| step-0-capture.md | ステップ0 — キャプチャ、ブランドと製品の理解、戦略ファーストのサイトサマリー作成 |
| step-1-design.md | ステップ1 — DESIGN.md ブランドチートシートの作成(5セクション、250-350行。ビルボードスタイルのソーシャル広告向けに50行の高速パスあり) |
| step-2-brief.md | ステップ2 — メッセージ、ナラティブアーク、オーディエンスについてユーザーと合意 |
| capabilities.md | ステップ2 & 5 — HyperFramesで可能なことの全インベントリ(24セクション)。ブリーフィング時に目次をスキャンし、ビルド時に特定セクションを深掘り |
| step-3-storyboard.md | ステップ3 — ストーリーボード + 脚本(統合)、ユーザーレビューゲートあり |
| step-4-vo.md | ステップ4 — TTSプロバイダーの選択、生成、タイミング |
| step-5-build.md | ステップ5 — index.html + コンポジションのビルド |
| step-6-validate.md | ステップ6 — lint、検証、スナップショット(動画尺に応じてスケール)、プレビュー |
| techniques.md | ステップ3 & 5 — 13のプリミティブアニメーションテクニックとコードパターン(適応して使用、コピーペーストしない) |
| html-in-canvas-patterns.md | ステップ5 — HTML-in-Canvasエフェクトの完全なコードパターン(hyperframesスキル内にあり) |