Communitygithub.com

Lord1Egypt/awesome-skill-forge

HyperFrames を使用して、HTML ベースのビデオコンポジション、アニメーションタイトルカード、ソーシャルオーバーレイ、キャプション付きトーキングヘッド動画、オーディオリアクティブビジュアル、シェーダートランジションを作成します。HTML をビデオの信頼できる情報源として、ユーザーが HTML コンポジションから MP4/WebM をレンダリングしたい場合、メディア上でテキスト/ロゴ/チャートをアニメーションさせたい場合、音声に同期したキャプションが必要な場合、TTS ナレーションを生成したい場合、またはウェブサイトをビデオに変換したい場合に使用します。

awesome-skill-forge とは?

このスキルは、**HyperFrames** エンジンを活用して、HTML、CSS、JavaScript(GSAP アニメーション)から決定論的に MP4/WebM ビデオファイルを生成するためのプロフェッショナルグレードのツールキットです。HTML をビデオの信頼できる情報源(source of truth)として扱い、`data-*` 属性でタイミング制御を行う独自のアプローチにより、ピクセル単位の正確なモーショングラフィックス、タイポグラフィックイントロ、キャプション付きトーキングヘッド動画、製品ツアー、ソーシャルオーバーレイ(Instagram/TikTok/YouTube スタイル)、オーディオリアクティブビジュアル(ビート同期、スペクトラムバー)、および複雑なシェーダートランジション(ホワイトフラッシュスルー、リキッドワイプなど)の作成に優れています。 主なユースケースは、数学的な説明アニメーション(→ `manim-video` を使用)ではなく、マーケティング、ソーシャルメディア、プレゼンテーション向けのリッチなモーショングラフィックスビデオの生成です。完全なワークフローは、ビジュアルアイデンティティの定義(DESIGN.md によるハードゲート)、プロジェクトのスキャフォールディング、ヒーローフレーム(静的レイアウト)の構築、決定論的な GSAP タイムラインの作成、シーントランジションの追加、TTS とキャプションの管理、そしてリンティング、検証、プレビュー、レンダリングという厳格なパイプラインに従います。 このスキルは、Node.js >=22 と FFmpeg がインストールされた環境で動作し、Chrome のヘッドレスシェルを使用してピクセル完全なキャプチャを行います。`npx hyperframes` コマンドで簡単に操作でき、`--docker` フラグを使用して再現可能なビルドが可能です。注意点として、`repeat: -1` の使用禁止や、タイムライン構築における非同期処理の禁止など、いくつかの厳格なルールがあります。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Lord1Egypt/awesome-skill-forge/tree/HEAD/optional-skills/hyperframes

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

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

ドキュメント

HyperFrames

HTML はビデオの信頼できる情報源(source of truth)です。コンポジションは、タイミングのための data-* 属性、アニメーションのための GSAP タイムライン、および外観のための CSS を備えた HTML ファイルです。HyperFrames エンジンは、ページをフレームごとにキャプチャし、FFmpeg を使用して MP4/WebM にエンコードします。

manim-video との補完関係: 数式・幾何学的な解説(方程式、3B1B スタイル)には manim-video を使用してください。モーショングラフィックス、キャプション付きトーキングヘッド、製品ツアー、ソーシャルオーバーレイ、シェーダートランジション、および実際のビデオ/オーディオメディアによって駆動されるものには hyperframes を使用してください。

使用するタイミング

  • ユーザーがテキスト、スクリプト、またはウェブサイトからレンダリングされたビデオを要求したとき
  • アニメーションタイトルカード、ローワーサード、タイポグラフィックイントロ
  • キャプション付きナレーションビデオ(TTS + 波形に同期したキャプション)
  • オーディオリアクティブビジュアル(ビート同期、スペクトラムバー、パルスグロー)
  • シーン間のトランジション(クロスフェード、ワイプ、シェーダーワープ、フラッシュスルーホワイト)
  • ソーシャルオーバーレイ(Instagram/TikTok/YouTube スタイル)
  • ウェブサイトからビデオへのパイプライン(URL をキャプチャしてプロモーション動画を生成)
  • ビデオファイルに決定論的にレンダリングする必要がある任意の HTML/CSS/JS アニメーション

このスキルを使用しない場合:

  • 純粋な数式・方程式アニメーション(→ manim-video)
  • 画像生成またはミーム(→ meme-generation、画像モデル)
  • ライブビデオ会議またはストリーミング

クイックリファレンス

npx hyperframes init my-video               # プロジェクトをスキャフォールド
cd my-video
npx hyperframes lint                        # プレビュー/レンダリング前に検証
npx hyperframes preview                     # ライブリロードブラウザプレビュー(ポート 3002)
npx hyperframes render --output final.mp4   # MP4 にレンダリング
npx hyperframes doctor                      # 環境の問題を診断

レンダリングフラグ: --quality draft|standard|high · --fps 24|30|60 · --format mp4|webm · --docker(再現可能) · --strict。

完全な CLI リファレンス: references/cli.md。

セットアップ(1回限り)

bash "$(dirname "$(find ~/.hermes/skills -path '*/hyperframes/SKILL.md' 2>/dev/null | head -1)")/scripts/setup.sh"

このスクリプトは:

  1. Node.js >= 22 と FFmpeg がインストールされていることを確認します(インストールされていない場合は修正手順を表示)。
  2. hyperframes CLI をグローバルにインストールします(npm install -g hyperframes@>=0.4.2)。
  3. Puppeteer を介して chrome-headless-shell を事前キャッシュします。これは、Chrome の HeadlessExperimental.beginFrame キャプチャパスを使用した最高品質のレンダリングに必須です。
  4. npx hyperframes doctor を実行し、結果を報告します。

セットアップが失敗した場合は references/troubleshooting.md を参照してください。

手順

1. HTML を書く前に計画する

コードに触れる前に、以下の点を明確にします:

  • 何を — ナラティブアーク、重要な瞬間、感情的なビート
  • 構造 — コンポジション、トラック(ビデオ/オーディオ/オーバーレイ)、時間
  • ビジュアルアイデンティティ — 色、フォント、動きの特徴(爆発的/映画的/流動的/技術的)
  • ヒーローフレーム — 各シーンについて、最も多くの要素が同時に表示される瞬間。これが最初に構築する静的レイアウトです。

ビジュアルアイデンティティゲート(ハードゲート)。 任意のコンポジション HTML を書く前に、ビジュアルアイデンティティを定義する必要があります。デフォルトまたは一般的な色(#333、#3b82f6、Roboto はこのステップがスキップされたことを示します)でコンポジションを作成してはなりません。以下の順序で確認します:

  1. プロジェクトルートに DESIGN.md があるか? → その正確な色、フォント、モーションルール、および「やってはいけないこと」の制約を使用します。

  2. ユーザーがスタイルを指定したか(例:「Swiss Pulse」、「ダークでテクニカル」、「ラグジュアリーブランド」)→ 最小限の DESIGN.md を生成します。## Style Prompt、## Colors(役割付きの 3~5 の 16 進数カラー)、## Typography(1~2 ファミリー)、## What NOT to Do(3~5 のアンチパターン)を含めます。

  3. 上記のいずれでもない場合? → HTML を書く前に 3 つの質問をします:

    • ムードは?(爆発的/映画的/流動的/技術的/カオティック/暖かい)
    • 明るいキャンバス or 暗いキャンバス?
    • ブランドカラー、フォント、またはビジュアルリファレンスはありますか?

    次に、回答から DESIGN.md を生成します。すべてのコンポジションは、そのパレットとタイポグラフィを DESIGN.md または明示的なユーザーの指示に遡らなければなりません。

2. スキャフォールド

npx hyperframes init my-video --non-interactive

テンプレート: blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph。--example <名前> で選択するか、--video clip.mp4 または --audio track.mp3 でメディアをシードします。

3. アニメーションの前にレイアウト

まず、ヒーローフレームの静的な HTML+CSS を書きます — GSAP はまだ使わないでください。.scene-content コンテナは、width:100%; height:100%; padding:Npx でシーンを埋め、display:flex + gap を使用します。パディングを使用してコンテンツを内側に押し込みます — コンテンツコンテナに position: absolute; top: Npx を決して使用しないでください(コンテンツが残りのスペースより高い場合にオーバーフローします)。

ヒーローフレームが正しく見えた後にのみ、gsap.from() エントランス(CSS 位置へアニメーション)と gsap.to() イグジット(CSS 位置からアニメーション)を追加します。

完全な data-attribute スキーマとコンポジションルールについては references/composition.md を参照してください。

4. GSAP でアニメーション

すべてのコンポジションは以下を満たす必要があります:

  • タイムラインを登録: window.__timelines["<composition-id>"] = tl
  • 一時停止状態で開始: gsap.timeline({ paused: true }) — プレイヤーが再生を制御します
  • 有限の repeat 値を使用する(repeat: -1 はキャプチャエンジンを壊します)。計算方法: repeat: Math.ceil(duration / cycleDuration) - 1。
  • 決定論的であること — Math.random()、Date.now()、またはウォールクロックロジックは使用しないでください。擬似ランダム性が必要な場合は、シード付き PRNG を使用します。
  • 同期構築 — タイムライン構築の周りで async/await、setTimeout、または Promise を使用しないでください。

コア GSAP API(トゥイーン、イージング、スターガー、タイムライン)については references/gsap.md を参照してください。

5. シーン間のトランジション

マルチシーンコンポジションにはトランジションが必要です。ルール:

  1. シーン間では常にトランジションを使用する — ジャンプカットは禁止。
  2. すべてのシーン要素に常にエントランスアニメーション(gsap.from(...))を使用する。
  3. 最終シーンを除き、イグジットアニメーションは決して使用しない — トランジション自体がイグジットです。
  4. 最終シーンはフェードアウトしても構いません。

シェーダートランジション(flash-through-white、liquid-wipe など)をインストールするには npx hyperframes add <transition-name> を使用します。全リスト: npx hyperframes add --list。

6. オーディオ、キャプション、TTS、オーディオリアクティブ、ハイライト

  • オーディオ: 常に個別の <audio> 要素(ビデオは muted playsinline)。
  • TTS: npx hyperframes tts "スクリプトテキスト" --voice af_nova --output narration.wav。音声一覧は --list。音声 ID の最初の文字は言語をエンコードします(a/b=英語、e=スペイン語、f=フランス語、j=日本語、z=中国語など)— CLI は音素化ロケールを自動推定します。上書きする場合のみ --lang を渡してください。非英語の音素化にはシステム全体に espeak-ng がインストールされている必要があります。
  • キャプション: npx hyperframes transcribe narration.wav → 単語レベルの文字起こし。文字起こしのトーンからスタイルを選択します(ハイプ / コーポレート / チュートリアル / ストーリーテリング / ソーシャル — references/features.md の表を参照)。言語ルール: 音声が英語であることが確認されていない限り、.en whisper モデルを使用しないでください — .en は非英語音声を書き起こす代わりに翻訳します。すべてのキャプショングループは、イグジットトゥイーンの後にハードな tl.set(el, { opacity: 0, visibility: "hidden" }, group.end) キルを持つ必要があります — そうしないと、グループが後続のグループに見える状態でリークします。
  • オーディオリアクティブビジュアル: オーディオ帯域(低音/中音/高音)を事前抽出し、タイムライン内でフレームごとに for ループを使用して tl.call(draw, [], f / fps) でサンプリングします — 単一の長いトゥイーンはオーディオに反応しません。低音 → scale(パルス)、高音 → textShadow/boxShadow(グロー)、全体振幅 → opacity/y/backgroundColor にマッピングします。イコライザーバーのクリシェは避けてください — コンテンツがビジュアルを導き、オーディオがその動作を駆動するようにします。
  • マーカースタイルハイライト: テキスト強調のためのハイライト、サークル、バースト、スクリブル、スケッチアウトエフェクトは、決定論的な CSS+GSAP です — references/features.md#marker-highlighting を参照してください。完全にシーク可能で、アニメーション SVG フィルターはありません。
  • シーントランジション: すべてのマルチシーンコンポジションはトランジションを使用する必要があります(ジャンプカット禁止)。CSS プリミティブ(プッシュスライド、ブラークロスフェード、ズームスルー、スタッガードブロック)またはシェーダートランジション(flash-through-white、liquid-wipe、cross-warp-morph、chromatic-split など。npx hyperframes add でインストール)から選択します。ムードとエネルギーの表は references/features.md#transitions にあります。同じコンポジション内で CSS トランジションとシェーダートランジションを混在させないでください。

7. リント、検証、検査、プレビュー、レンダリング

npx hyperframes lint              # 欠落している data-composition-id、重複トラック、未登録タイムラインをキャッチ
npx hyperframes validate          # 5 つのタイムスタンプでの WCAG コントラスト監査
npx hyperframes inspect           # ビジュアルレイアウト監査 — オーバーフロー、フレーム外要素、隠されたテキスト
npx hyperframes preview           # ライブブラウザプレビュー
npx hyperframes render --quality draft --output draft.mp4    # 高速イテレーション
npx hyperframes render --quality high --output final.mp4     # 最終納品

hyperframes validate はすべてのテキスト要素の背後にある背景ピクセルをサンプリングし、コントラスト比が 4.5:1(大きなテキストの場合は 3:1)未満の場合に警告します。hyperframes inspect はレイアウト面のコンパニオンです — 複数のタイムスタンプでページを実行し、静的リントでは見えない問題(4.5 秒でのみセーフエリアを超えて折り返すキャプション、タイトルが最も長いバリアントのときにオーバーフローするカード、トランジションシェーダーの背後に配置されてしまう要素)をフラグします。特に吹き出し、カード、キャプション、またはタイトなタイポグラフィを含むコンポジションでは inspect を実行してください。

8. ウェブサイトからビデオへ(ユーザーが URL を指定した場合)

references/website-to-video.md の 7 ステップキャプチャ・トゥ・ビデオワークフローを使用します: キャプチャ → DESIGN.md → SCRIPT.md → ストーリーボード → コンポジション → レンダリング → 納品。

落とし穴

  • HeadlessExperimental.beginFrame が見つかりません — Chromium 147+ でこのプロトコルが削除されました。hyperframes@>=0.4.2 を使用していることを確認してください(自動検出してスクリーンショットモードにフォールバックします)。エスケープハッチ: export PRODUCER_FORCE_SCREENSHOT=true。hyperframes#294 および references/troubleshooting.md を参照してください。
  • システム Chrome(chrome-headless-shell ではない) — レンダリングが 120 秒間ハングし、その後タイムアウトします。npx puppeteer browsers install chrome-headless-shell を実行してください(setup.sh がこれを行います)。hyperframes doctor はどのバイナリが使用されるかを報告します。
  • repeat: -1 がどこかにある — キャプチャエンジンを壊します。常に有限のリピート回数を計算してください。
  • 後で登場するクリップ要素に gsap.set() を使用する — 要素はページロード時に存在しません。代わりに、タイムライン内で、クリップの data-start 以降の時刻位置で tl.set(selector, vars, timePosition) を使用してください。
  • コンテンツテキスト内の <br> — 強制改行はレンダリングされたフォント幅を認識しないため、自然な折り返しと <br> で二重改行が発生します。max-width を使用してテキストを折り返させてください。例外: 各単語が意図的に独立した行にある短い表示タイトル。
  • visibility または display のアニメーション — GSAP はこれらをトゥイーンできません。autoAlpha(visibility と opacity の両方を処理)を使用してください。
  • video.play() または audio.play() の呼び出し — フレームワークが再生を所有します。自分でこれらを呼び出さないでください。
  • 非同期でのタイムライン構築 — キャプチャエンジンはページロード後に同期的に window.__timelines を読み取ります。タイムライン構築を async、setTimeout、または Promise でラップしないでください。
  • <template> でラップされたスタンドアロンの index.html — すべてのコンテンツがブラウザから隠されます。data-composition-src を介してロードされるサブコンポジションのみが <template> を使用します。
  • オーディオにビデオを使用する — 常にミュートされた <video> + 個別の <audio>。

検証

レンダリングの前後に行うこと:

  1. リント + 検証 + 検査に合格: npx hyperframes lint --strict && npx hyperframes validate && npx hyperframes inspect(リントは構造的問題を、検証はコントラストを、検査はビジュアルレイアウト/オーバーフロー問題をキャッチします — 警告が出た場合は troubleshooting.md を参照)。
  2. アニメーションチェック — 新しいコンポジションまたは重要なアニメーション変更の場合、アニマップを実行します。npx hyperframes init はスキルスクリプトをプロジェクトにコピーするため、パスはプロジェクトローカルです:
    node skills/hyperframes/scripts/animation-map.mjs <composition-dir> \
      --out <composition-dir>/.hyperframes/anim-map
    
    単一の animation-map.json を出力します。これには、トゥイーンごとの要約、ASCII ガントチャートタイムライン、スターガー検出、デッドゾーン(1 秒以上アニメーションなし)、要素ライフサイクル、およびフラグ(offscreen、collision、invisible、paced-fast <0.2s、paced-slow >2s)が含まれます。要約とフラグをスキャンし、修正するか正当化します。小さな編集ではスキップします。
  3. ファイルが存在し、サイズが 0 でないこと: ls -lh final.mp4。
  4. 再生時間が data-duration と一致すること: ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 final.mp4。
  5. 視覚的確認: コンポジション中途のフレームを抽出: ffmpeg -i final.mp4 -ss 00:00:05 -vframes 1 preview.png。
  6. 期待される場合にオーディオが存在すること: ffprobe -v error -show_streams -select_streams a -of default=nw=1:nk=1 final.mp4 | head -1。

hyperframes render が失敗した場合は、npx hyperframes doctor を実行し、その出力を報告時に添付してください。

リファレンス

  • composition.md — data 属性、タイムライン契約、不可侵ルール、タイポグラフィ/アセットルール
  • cli.md — すべての CLI コマンド(init, capture, lint, validate, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, benchmark)
  • gsap.md — HyperFrames 向け GSAP コア API(トゥイーン、イージング、スターガー、タイムライン、matchMedia)
  • features.md — キャプション、TTS、オーディオリアクティブ、マーカーハイライト、トランジション(オンデマンドロード)
  • website-to-video.md — 7 ステップキャプチャ・トゥ・ビデオワークフロー
  • troubleshooting.md — OpenClaw の修正、環境変数、一般的なレンダリングエラー

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a insurance agency. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generates a complete landing page with copy, layout, hero image, and responsive design from a text description. Use when launching a product quickly.

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a family law practice. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a fractional CFO firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a home remodeling company. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a HVAC service company. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a immigration law firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a CPA tax advisory firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a estate planning law firm. Use when handling...

Lord1Egypt/awesome-skill-forge

Fastest way to create or update a pawr.link profile. One curl command, $19 USDC to create, $0.10 to update. Patch-style update-links endpoint lets you add, remove, or move individual links without replacing the whole profile.

Lord1Egypt/awesome-skill-forge

Use this skill when the user wants to review today, look back on yesterday, reflect on this week, or wrap things up with a gentle, low-pressure reflection.

Lord1Egypt/awesome-skill-forge

Read-only queue dashboard for workspace-aware ship. (gstack)

Lord1Egypt/awesome-skill-forge

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, LP audit, conversion rate, landing page CRO, post-click CRO, or landing page optimization.

Lord1Egypt/awesome-skill-forge

Search arXiv papers by keyword, author, category, or ID.

Lord1Egypt/awesome-skill-forge

Delegate coding to OpenAI Codex CLI (features, PRs).

Lord1Egypt/awesome-skill-forge

Track Apple devices/AirTags via FindMy.app on macOS.

Lord1Egypt/awesome-skill-forge

Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN.

Lord1Egypt/awesome-skill-forge

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.

Lord1Egypt/awesome-skill-forge

Notion API + ntn CLI: pages, databases, markdown, Workers.

Lord1Egypt/awesome-skill-forge

p5.js sketches: gen art, shaders, interactive, 3D.

関連スキル