HyperFrames — ここから始める
HyperFrames は HTML からビデオをレンダリングします。コンポジションは HTML ファイルであり、その DOM は data-* 属性でタイミングを宣言し、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが管理します。完全なオーサリング規約は /hyperframes-core にあります。コンポジション HTML を作成する前にそれを読んでください。
以下は、機能マップ(オンデマンドでロードされるドメインスキル)と 意図ルーター(「ビデオを作って」というリクエストにワークフローを割り当てる)です。
機能マップ — ドメインスキル
オンデマンドでロードするアトミックな機能であり、完全なビデオワークフローではありません。「ビデオを作って」というリクエストには、以下の意図ルーターを使用してください。
| 目的 | スキル |
|---|---|
HTML コンポジションの作成/編集 — data-* 規約、クリップ、トラック、サブコンポジション、変数 | /hyperframes-core |
| アニメーション — アトミックモーション、シーンブループリント、トランジション、ランタイムアダプター (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
シークセーフなキーフレームの作成 — GSAP タイムライン、CSS キーフレーム、Anime.js、WAAPI、FLIP、パス、マスク、SVG モーフ/描画、3D 深度、hyperframes keyframes 診断 | /hyperframes-keyframes |
クリエイティブディレクション — frame.md / design.md、パレット、タイポグラフィ、ナレーション、ビート計画、オーディオリアクティブ | /hyperframes-creative |
| メディア — TTS ボイスオーバー、BGM、文字起こし、背景除去、キャプション | /hyperframes-media |
メディア解決 — HeyGen カタログから BGM、SFX、画像、アイコンを検索・固定して .media/ にマニフェストトラッキング付きで配置 | /media-use |
| CLI 開発ループ — init、lint、validate、inspect、preview、render、publish、doctor | /hyperframes-cli |
レジストリブロック/コンポーネントのインストール (hyperframes add) | /hyperframes-registry |
意図ルーティング — ワークフローを選ぶ
このセクションはトップレベルのワークフローのみを知っており、内部の参照や上記のドメインスキルをロードしません。
ルーティング前 — 仕様ではなく入力を確認
ルーティングでは、ビデオが何についてのものか、つまりその入力と主題を知る必要があります。それが未指定の場合(URL、製品、トピック、アセットなしで「私たちの製品のビデオを作って」)、いずれのワークフローに入る前に確認してください。ワークフローへのコミットメント自体がルーティングの決定です。最大2つの質問:
- 入力 — 製品(URL / ブリーフ)、一般的なウェブサイト、GitHub PR、説明するトピック、または既存の talking-head ビデオ?
スペックのデフォルト — 状態を述べる、質問しない(ルートを変えることは決してありません):アスペクト比 16:9(9:16 は TikTok / Reels / Shorts など名前付きの縦型宛先にのみ使用);ナレーション/キャプションの 言語 = ユーザーの言語。選択されたワークフローは、最初のステップで独自の詳細を再確認します。
ワークフロー早見表
| ワークフロー | 使用するケース |
|---|---|
/product-launch-video | 製品を販売する場合(SaaS、アプリ、企業/製品サイト) — URL、ブリーフ、スクリプトから プロモ を作成。商用URLのデフォルト(サイト名のみでも)。 |
/website-to-video | サイト自体を紹介する場合 — サイトのスクリーンショットから構築されたツアー/ショーケース。非商用サイト(ポートフォリオ、ブログ、ドキュメント、個人、イベント)向け、またはユーザーがプロモではなくツアーを希望する場合。 |
/faceless-explainer | トピック/コンセプトを説明する場合 — テキストから、製品やURLなし。すべてのビジュアルは LLM が生成。 |
/pr-to-video | GitHub PR / コード変更 → チェンジログ / 機能紹介 / 修正 / リファクタリング解説 |
/embedded-captions | 既存の talking-head ビデオに キャプション/字幕を追加(映像はそのまま) |
/talking-head-recut | 既存の talking-head ビデオをデザインされたグラフィックオーバーレイでパッケージ化 — ローワーサード、データコールアウト、キネティックタイトル、プルクオート |
/motion-graphics | 短いナレーションなし、デザイン主導のモーショングラフィック — キネティックタイポ、統計/チャートヒット、ロゴスティング、ローワーサードオーバーレイ |
/music-to-video | 音楽トラック → ビート同期ビデオ — リリックビデオ、スライドショー、またはキネティックプロモ。音楽がペーシングを決定(オプションでユーザーの画像/ビデオをビートグリッドにカット) |
/slideshow | プレゼンテーション / ピッチデッキ / インタラクティブデッキ — 個別のスライド、フラグメント、ブランチング、ホットスポット。出力はナビゲーション可能なデッキ、レンダリングされたビデオではない |
/general-video | その他すべて — より長い、またはマルチシーンの作品、静的ループ/ポスター、カスタムコンポジション |
/remotion-to-hyperframes | 既存の Remotion (React) コンポジションを HyperFrames に移植(移行、新規作成ではない) |
曖昧性解消(紛らわしい場合のみ):
- モーション優先&ナレーションなし(約10秒未満で、モーション自体がメッセージ)→
/motion-graphics。入力は問わない。 - URL またはスクリプト — 一つだけ確認する:そのサイトは製品を販売しているか? はい(SaaS / アプリ / 製品 / 企業サイト)→
/product-launch-video— プロモ。商用URLのデフォルト(サイト名のみでも)。いいえ、またはユーザーがサイトをそのまま表示したいだけ(ポートフォリオ / ブログ / ドキュメント / 個人 / イベント)→/website-to-video— ツアー。GitHub PR リンク →/pr-to-video。製品やサイトのないコンセプト →/faceless-explainer。 - 既存の映像 — プレーンな音声の字幕 →
/embedded-captions;デザインされたオーバーレイカード →/talking-head-recut。どちらも映像そのものを編集しない(再タイミング / 再配色 / 再フレーム / 並び替え / オーディオは NLE 編集 — 範囲外)。 - 音楽トラックが入力(オーディオファイル、またはオーディオを抽出するビデオ)でナレーションなし →
/music-to-video— 音楽のビート/エネルギーがペーシングを決定。(ナレーション付きの作品は上記の入力に一致するワークフローに留まる;/motion-graphicsは音楽駆動ではない短いナレーションなしのモーション用)。 - プレゼンテーション / ピッチデッキ / インタラクティブデッキ(個別のスライド、ナビゲーション、プレゼンターモード)→
/slideshow— 出力はナビゲーション可能なデッキ、レンダリングされたビデオではない。明示的な「スライドショー」リクエストは直接進む;隣接するトリガー(「デッキ / スライド / プレゼンテーション / このページを変換」)は、/slideshowがスライドショーであることを確認してからオーサリングし、そうでなければ適切な非スライドショーワークフローに切り替える。 - 長さはガイドであってゲートではない — 意図がワークフローを選ぶ;作品が明らかに約3分より長い場合、または静的/ループ/カスタム形式の場合にのみ
/general-videoへ。
マッチしたワークフローがインストールされていない場合
ワークフローを選択したら、それが実際に利用可能か確認してください。マッチしたワークフロースキルがインストールされていない場合、推測に頼らず、ユーザーに最初にインストールするよう伝えてください:
- このワークフローのみ:
npx skills add heygen-com/hyperframes --skill <workflow-name>(例:--skill pr-to-video— ベアネーム、先頭の/なし)。 - すべてのワークフローを一度に:
npx skills add heygen-com/hyperframes --all(コア + すべてのワークフロー、ピッカーをスキップ)。
ユーザーが実行した後、ワークフローのスキルを再読み込みして続行します。
スキルを最新に保つ
HyperFrames スキルはバージョン管理されています。npx hyperframes init は、インストールされているスキルを GitHub の最新版と比較し、何かが古いか不足している場合はフルセットをインストール/更新します。したがって、新しく初期化されたプロジェクトは常に完全で最新のセットを持ちます(最新のプロジェクトで init を再実行しても何も起こりません)。この確認は迅速な GitHub ラウンドトリップです。オフライン(またはレート制限)の場合、短いタイムアウト後にインストールにフォールバックするため、init がネットワークの問題でハードフェイルすることはありません。作成ワークフローは init でスキャフォールドするため、新しいプロジェクトを開始するたびにこの確認が実行され、古い場合には GitHub から最新のスキルを取得します。--skip-skills フラグは現在無効化されています(skills.sh レジストリが追いつくまでの一時的な措置):これを渡してもチェックはスキップされないため、すべての init が GitHub をチェックします。CI/テストは HYPERFRAMES_SKIP_SKILLS=1 環境変数でオプトアウトします。
タスクが予期せぬ動作をする場合、または長時間のビルドの前に、インストールされているスキルが最新であることを確認してください:
- 確認:
npx hyperframes skills check(--jsonを追加して機械可読な判定を出力。何かが古いまたは不足している場合は非ゼロで終了)。 - 更新:
npx hyperframes skills update— フルセットを最新版にプルし、まだ存在しないものをインストール(init のインストールステップと同じ)。
CLI は、render / lint / validate の実行時に古いスキルを検出すると、1行のリマインダーも表示します。
ワークフローの詳細
/product-launch-video
- 入力: マーケティング対象の製品 — (a) 製品URL(ヘッドレスChromeでクロールし、アセット+ブランドトークンを取得)、(b) 製品のサイトを名前だけでも記載したスクリプト/ブリーフ(PLV が解決してクロールする。ユーザーがオプトアウトしない限り)、または (c) 派生可能なサイトがない/「スクレイピングしない」スクリプト(キャプチャなしモード — パレット+デザインシステムを提供するスタイルプリセットを選択)。提供されたスクリプトは、逐語的なボイスオーバーか、シーンごとに再構成されたものか — PLV が確認します。
- 出力: 製品ローンチ / SaaS プロモの HyperFrames コンポジション → MP4(最適時間30〜90秒)。製品の価値が主題であり、サイトのウォークスルーではありません。サイトの単なるツアーの場合は
/website-to-videoを使用してください。 - トリガー: 「Xのローンチビデオ」、「私たちのサイトのプロモ」、「私のSaaSを1分で説明して」、「私のスクリプトを60秒のプロモに」、「スクリプトのみのローンチビデオ、スクレイピングしない」。
/website-to-video
- 入力: ウェブサイト/URLで、目的はサイト自体を表示することであり、製品を販売することではありません。非商用サイト(ポートフォリオ、ブログ、ドキュメント、個人、イベント)に最適、またはユーザーがサイトをそのままツアーしたい場合に明示的に選択します。ヘッドレスChromeで実際のスクリーンショット+ブランドアセットをキャプチャします。サイトが何かを販売しており、ユーザーがプロモを希望する場合は
/product-launch-videoを使用してください。 - 出力: サイトのビジュアルから構築されたサイトツアー / ショーケース / ソーシャルクリップ → MP4。
- トリガー: 「このウェブサイトをビデオに」、「 からのサイトツアー」、「ホームページからのソーシャルクリップ」、「URLだけある — 何か作って」。
/faceless-explainer
- 入力: 任意のテキスト — トピック、記事、またはメモ — が説明対象であり、マーケティングされる製品もキャプチャするサイトもありません。(
/product-launch-videoからフォーク;ヘッドレスChromeなし)。 - 出力: 顔出しなし解説 → MP4。すべてのビジュアルはシーンごとに LLM が生成(タイポグラフィ / 抽象 / 図 / データ可視化)。
pin-and-paperプリセットを同梱(最適時間30〜90秒)。 - トリガー: 「Xについての顔出しなし解説」、「DNSの仕組みをビデオで説明して」、「この記事を解説ビデオに」、「メモからの解説」。
/pr-to-video
- 入力: GitHub プルリクエスト — PR URL、
owner/repo#N参照、または「このPR」 —ghCLI 経由で読み取り(スクレイピングするサイトではない)。 - 出力: コード変更の解説(チェンジログ / 機能紹介 / 修正 / リファクタリング)→ MP4 — diff ハイライト、before/after、ファイルツリー+インパクトシーン。≤(最適時間30〜90秒)。
- トリガー: 「このPRのビデオを作って」、「PR #1187 をチェンジログビデオに」、「リリースノートビデオを github.com/org/repo/pull/123 から」。
/embedded-captions
- 入力: 既存の talking-head ビデオ(MP4)にキャプションを追加 — 実際の映像、URL やブリーフではない。ローカルで文字起こし(Whisper、APIキー不要)し、マット処理(RVM)して被写体がキャプションを隠せるようにします。
- 出力: 同じ映像をそのまま、キャプション層を追加 — 標準(逐語的なローワーサードレール+被写体の後ろに埋め込まれたクライマックス)またはシネマティック(すべてのキャプションを被写体の後ろに合成)。任意の長さ。
- トリガー: 「このビデオにキャプション/字幕を追加」、「被写体の後ろにキャプション」、「私のクリップにシネマティックキャプション」。
/talking-head-recut
- 入力: 既存の talking-head / インタビュー / ポッドキャストビデオ(MP4)を、画面上のグラフィックでパッケージ化する — 実際の映像。ローカルで文字起こし(Whisper)。クリップはそのまま完全に再生され、変更されません。
- 出力: 同じ映像に、タイミング調整されたグラフィックオーバーレイカード — キネティックタイトル、ローワーサード、データコールアウト、プルクオート、サイドパネル、ピクチャーインピクチャー — をトランスクリプトに同期。任意の長さ。
- トリガー: 「このビデオをパッケージ化」、「私のトークにグラフィックオーバーレイ/ローワーサード/データコールアウトを追加」、「