Communitygithub.com

jonosin/jstack

HeyGen HyperFrames へのシンルーター — HTMLネイティブのモーショングラフィックスエンジン(HTML を書き、ヘッドレス Chrome + FFmpeg で決定論的な MP4 をローカルレンダリング)。ユーザーが「hyperframe」「hyperframes」「アニメーションオーバーレイ」「モーショングラフィックス」「HTML to video」「アニメーションキャプション」「アニメーションフックテキスト」「キネティックキャプション」「キネティックタイトル」「エンドカード」「lower third」と発言した場合、あるいは HTML コンポジションを作成・レンダリングして MP4 に出力したい、HyperFrames ブロックカタログを閲覧したい場合に使用します。生成系ビデオ(/vidgen)や StayFrame 静的テキストオーバーレイ(/jstack-sf-caption)には使用しません。

jstack とは?

このスキルは、HeyGen HyperFrames へのシンルーターとして機能します。HyperFrames は Apache-2.0 ライセンスのオープンソースプロジェクトで、HTML/CSS/JS のコンポジションを決定論的な MP4 動画に変換します。レンダリングはヘッドレス Chrome で各フレームをキャプチャし、FFmpeg でエンコードすることで実現します。このスキル自体はルーティングのみを行い、実際の知識やワークフローはクローンされたリポジトリ内のドキュメントや 20 のエージェントスキルに委譲します。サポートするプラットフォームは Claude Code などの AI エージェントで、ユーザーからの「hyperframe」「モーショングラフィックス」「キネティックタイトル」などの意図を検出し、適切な上流スキル(/motion-graphics、/embedded-captions、/hyperframes-core など)にルーティングします。また、70 以上のブロック・コンポーネント(lower thirds、コード表示、ロゴアウトロ、グリッチ、データチャートなど)のレジストリを持ち、`npx hyperframes init` でプロジェクトをスキャフォールドし、`npm run render` で MP4 を出力します。StayFrame との境界線も明確で、静的テキストオーバーレイや生成系ビデオにはルーティングしないよう設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

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

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

ドキュメント

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-captionStayFrame リールにプレーンな静的テキストオーバーレイが必要な場合 — そのレーンは HyperFrames ではなく、ヘッドレス Chrome + ffmpeg を使用し続けます。
/jstack-sf-trim-stitchレンダリングされた HyperFrames オーバーレイ/エンドカードを StayFrame リールにアセンブルする必要がある場合。

関連スキル