hyperframe — HeyGen HyperFrames へのルーター
HyperFrames(Apache-2.0、github.com/heygen-com/hyperframes)は、HTML/CSS/JS のコンポジションを決定論的な MP4 に変換します。レンダラーはヘッドレス Chrome で各フレームを取得し、FFmpeg でエンコードします。 このスキルはシンルーターです — 実際の知識はすべて、クローンされたリポジトリとその 20 のエージェントスキルにあります。上流のドキュメントをここに複製しないでください。
ローカルパス
解決順序: HYPERFRAMES_HOME 環境変数 → ~/.jstack/config.env → 以下のデフォルト。
| 内容 | 場所 |
|---|---|
| クローンされたリポジトリ(正規のローカルコピー) | ~/.jstack/vendor/hyperframes |
| 上流ルータースキル(ビデオ作成リクエストがあれば最初に読む) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
その 20 のエージェントスキル(hyperframes init により ~/.claude/skills/ と ~/.agents/skills/ にもインストールされる) | ~/.jstack/vendor/hyperframes/skills/ |
ブロック/コンポーネントレジストリ(70 以上のブロック: lower-thirds lt-*、code-*、logo-outro、glitch、data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| ドキュメントソース(Quickstart、概念、リファレンス、カタログ) | ~/.jstack/vendor/hyperframes/docs/ |
| オンライン: ドキュメントとブロックカタログ | hyperframes.heygen.com(Quickstart/Docs/Catalog)、hyperframes.dev(プレイグラウンド + デザインテンプレート) |
インストール / ヘルスチェック
必要条件: PATH 上に Node 22+ と FFmpeg(このマシンで動作確認済み、CLI v0.7.48)。
npx --yes hyperframes doctor # 環境ヘルスチェック
npx --yes hyperframes init my-video # プロジェクトをスキャフォールド(エージェントスキルもインストール/更新)
cd my-video && npm run render # → renders/*.mp4
init は index.html + hyperframes.json をスキャフォールドし、package.json のスクリプト(dev/check/render/publish)に CLI バージョンを固定します。クローンを更新するには:
git -C ~/.jstack/vendor/hyperframes pull
ディスパッチテーブル
意図をルーティングし、上流のターゲットを開く/実行します — ワークフローを独自に実装しないでください。
| 意図 | 遷移先 |
|---|---|
| 「ビデオ/アニメーションを作って」リクエスト(エントリポイント) | /hyperframes ルータースキルを読む: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — ワークフローを選択 |
| アニメーションフックテキスト / キネティックタイトル / スタットヒット / ロゴスティング / エンドカード / lower-third(短く、ナレーションなし、デザイン主導) | /motion-graphics ワークフロー: クローン内の skills/motion-graphics/; lower-third ブロック = レジストリ lt-*、エンドカード = logo-outro |
| 既存のトーキングヘッド動画に対するキネティックキャプション / 字幕 | /embedded-captions ワークフロー: skills/embedded-captions/(映像はそのまま、キャプションを重ねてレンダリング) |
HTML→MP4 コンポジションの作成・編集(data-* タイミング契約、クリップ、トラック) | /hyperframes-core 次に /hyperframes-animation: skills/hyperframes-core/、skills/hyperframes-animation/ |
| ブロックとコンポーネントの閲覧・インストール | レジストリディレクトリ registry/{blocks,components} または hyperframes.heygen.com/catalog; npx hyperframes add [block] でインストールと配線 |
| コンポジションのレンダリング / プレビュー / リント / 検証 | /hyperframes-cli: npx hyperframes preview、npx hyperframes lint && npx hyperframes validate、npx hyperframes render、npx hyperframes doctor |
| コンポジション用の BGM / SE / ナレーション / アイコン / 背景除去 | /media-use: skills/media-use/ |
| デッキ / スライドショー、製品プロモ、PR-to-video、音楽同期、ウェブサイトツアー、Remotion 移植 | 一致するワークフロースキル(skills/ 内。/hyperframes ルーターのチートシート参照) |
使用しない場合(StayFrame レッドライン)
StayFrame のフィード美学の北極星(ADR 0002、編集ミニマル — 「これは Aman/Soneva のグリッドに気づかれずに収まるか?」)は、派手なモーショングラフィックススタイルをブランド外とします: Hormozi スタイルのキネティックキャプション、グリッチ/VFX ブロック、ニュースティッカー、リキッドガラスウィジェット。StayFrame リールでは、控えめなミニマルオーバーレイにのみ HyperFrames を使用し、以下に従ってください:
- 静的テキストオーバーレイは既存のレーンに留める — ヘッドレス Chrome + ffmpeg を
/jstack-sf-captionで使用。HyperFrames に移行しないでください。 - 生成系ビデオ(i2v/t2v)は決して HyperFrames ではありません — それは
/vidgenです。
注意点
hyperframes initには--yesフラグがありません(不明なフラグはエラーになります)。すでに非対話的です。initの副作用: HyperFrames 自身のコアスキルを~/.claude/skills/と~/.agents/skills/にインストール/更新します — 想定内で、上流ルーターを最新に保ちます。- スキルのスタンドアロンインストール:
npx skills add heygen-com/hyperframes --full-depth—--full-depthを指定しないと、mainに遅れたスキル.sh レジストリブロブが取得されます。 - テレメトリーはデフォルトで有効です。無効にするには
hyperframes telemetry disable。 - レンダリング出力はプロジェクトディレクトリ内の
renders/[project]_[timestamp].mp4に保存されます。
次のスキル
| 次 | 条件 |
|---|---|
/vidgen | コンポジションに生成された映像(i2v/t2v クリップ)をソース素材として必要とする場合 — ビデオ生成は常にこちらにルーティングされ、バックエンドに直接送られることはありません。 |
/jstack-sf-caption | StayFrame リールにプレーンな静的テキストオーバーレイが必要な場合 — そのレーンは HyperFrames ではなく、ヘッドレス Chrome + ffmpeg を使用し続けます。 |
/jstack-sf-trim-stitch | レンダリングされた HyperFrames オーバーレイ/エンドカードを StayFrame リールにアセンブルする必要がある場合。 |