Communitygithub.com

s2530786-cell/ION-DEX

HyperFrames HTMLを使用してビデオコンポジション、アニメーション、タイトルカード、オーバーレイ、キャプション、ナレーション、音声反応型ビジュアル、シーントランジションを作成します。HTMLベースのビデオコンテンツ制作全般、オーディオに同期したキャプション/字幕の追加、テキスト読み上げ、音楽に連動したビートシンク/グロー/パルスアニメーション、アニメーション付きテキストハイライト、シーン間のトランジションをカバーします。

ION-DEX とは?

ION-DEXは、HyperFramesフレームワークを活用したAIエージェント用スキルで、HTMLをソースオブトゥルースとするビデオコンポジションの作成・編集を専門とします。このスキルは、タイトルカード、アニメーション、オーバーレイ、キャプション、ナレーション(TTS)、音声反応型ビジュアル(ビート同期、グロー、パルス)、アニメーションハイライト(マーカースイープ、手書きサークル、バーストライン)、およびクロスフェードやワイプなどのシーントランジションなど、ビデオ制作ワークフローの全範囲をカバーします。Claude Code, Cursor, CodexなどのAIエージェントと連携し、ユーザーのリクエストに応じて、デザインシステム(design.md)の読み込み、プロンプト拡張、シーンリズムの計画、レイアウト(終了状態を先に構築)、GSAPアニメーションの段階的なアプローチを採用します。特に、ビデオコンポジションの構造定義(data-*属性)、サブコンポジションの読み込み、パラメータ化された変数による動的なコンテンツ差し替えをサポートしており、大規模なビデオ制作やブランド一貫性が求められるプロジェクトに適しています。また、探索的なリクエストに対しては、視覚スタイルの選択肢を提供し、ユーザーがデザインピッカーを介してブラウザ上でスタイルを設定できる機能も備えています。

対応~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/s2530786-cell/ION-DEX/tree/HEAD/.cursor/skills/hyperframes

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

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

ドキュメント

HyperFrames

HTMLがビデオのソースオブトゥルースです。コンポジションは、タイミング用のdata-*属性、アニメーション用のGSAPタイムライン、および外観用のCSSを持つHTMLファイルです。フレームワークがクリップの可視性、メディア再生、およびタイムライン同期を処理します。

アプローチ

発見(探索的リクエストのみ)

ユーザーが方向性を決めていないオープンエンドなリクエスト(「製品発表ビデオを作って」「ブランドの何かを作成して」)の場合、色を選ぶ前に意図を理解します:

  • 視聴者 — 誰が見るのか? 開発者? 役員? 一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャル(15秒)、ウェブサイトヒーロー、製品デモ、社内?
  • 優先順位 — 最も重要なものは? モーションの品質? コンテンツの正確性? ブランドの忠実性? 速度?
  • バリエーション — ユーザーはオプションを欲しているのか、それとも単一の最良の結果を望んでいるのか?

具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、発見をスキップします。

探索的リクエストの場合は、単なる色の変更ではなく、異なるペーシング、エネルギーレベル、または構造的アプローチを備えた、意味のある違いがある2〜3のバリエーションを提供することを検討します。1つは安全/期待通り、もう1つは野心的です。これは必須ではありません — 適切な場合に利用可能なツールです。

ステップ1: デザインシステム

design.mdまたはDESIGN.mdがプロジェクトに存在する場合は、最初にそれを読みます(両方の大文字小文字を確認 — Linuxでは別のファイルです)。ブランドカラー、フォント、制約のソースオブトゥルースです。正確な値を使用します — 色を発明したりフォントを代用したりしないでください。任意の形式で機能します(YAMLフロントマター、散文、テーブル — 値を抽出するだけです)。

ローカルで見つからないフォント( fonts/ ディレクトリに .woff2 ファイルがなく、組み込みフォントでもない)が指定されている場合は、HTMLを書く前にユーザーに警告します:「design.mdは[フォント名]を指定していますが、フォントファイルが見つかりません。.woff2ファイルをfonts/に追加するか、最も近い組み込みの代替フォントにフォールバックします。」

design.mdが存在しない場合は、ユーザーに選択肢を提供します:

  1. ユーザーがスタイルやムードを指定しましたか? → visual-styles.mdにある8つの名前付きプリセットを読みます。最も近いものを選びます。
  2. 視覚的にオプションを閲覧しますか? → デザインピッカーを実行します:references/design-picker.mdの完全なワークフローを読みます。これは視覚的なピッカーページを提供します。ユーザーはブラウザでムード、パレット、タイポグラフィ、モーションを設定し、生成されたdesign.mdをコピーして会話に貼り付けます。
  3. スキップして速く進みますか? → ムード、ライトかダークか、ブランドカラー/フォントを尋ねます。次に、house-style.mdからパレットを選びます。

design.mdはブランドを定義します。ビデオコンポジションのルールは定義しません。 それらはreferences/video-composition.mdとhouse-style.mdから来ます。ブランドカラーは、ビデオに適したスケールで使用します — Web UIの不透明度ではありません。

ステップ2: プロンプト拡張

すべてのコンポジションで常に実行します(単一シーンの作品と些細な編集を除く)。このステップは、ユーザーの意図をdesign.mdとhouse-style.mdに照らして具体化し、すべての下流エージェントが同じように読み取る一貫した中間体を生成します。

完全なプロセスと出力形式については、references/prompt-expansion.mdを読んでください。

ステップ3: 計画

HTMLを書く前に、高いレベルで考えます:

  1. 何を — 視聴者は何を体験すべきか? 物語の弧、重要な瞬間、感情的なビートを特定します。
  2. 構造 — いくつのコンポジションがあり、どれがサブコンポジションでどれがインラインか、どのトラックが何を運ぶか(ビデオ、オーディオ、オーバーレイ、キャプション)。
  3. リズム — 実装前にシーンリズムを宣言します。どのシーンがクイックヒットで、どれがホールドか、シェーダーはどこに着地するか、エネルギーはどこでピークになるか。パターンに名前を付けます:fast-fast-SLOW-fast-SHADER-hold。リズムテンプレートについてはreferences/beat-direction.mdを読んでください。
  4. タイミング — どのクリップが持続時間を決定し、トランジションはどこに着地し、ペーシングはどうなるか。
  5. レイアウト — 最初に終了状態を構築します。以下の「アニメーションの前にレイアウト」を参照してください。
  6. アニメーション — 次に、以下のルールを使用してモーションを追加します。

依頼されたものを構築します。 「タイトルカード」のリクエストは、「タイトルカード+3つのサポートシーン+アンビエントミュージック+キャプション」のリクエストではありません。すべてのシーン、すべての要素、すべてのトゥイーンは、その場所に値する必要があります。追加のシーンや要素が作品を真に向上させる場合は、提案します — 追加しません。

小さな編集(色の修正、タイミングの調整、1つの要素の追加)の場合は、ルールに直接スキップします。

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

すべての要素を、最も見える瞬間 — 完全に入力され、正しく配置され、まだ終了していないフレーム — に配置します。これを最初に静的なHTML+CSSとして書きます。GSAPはまだありません。

なぜこれが重要なのか: オフスクリーン、スケール0、不透明度0などのアニメーション開始状態に要素を配置し、着地するところまでトゥイーンすると、最終的なレイアウトを推測することになります。オーバーラップはビデオがレンダリングされるまで見えません。最初に終了状態を構築することで、モーションを追加する前にレイアウトの問題を確認して修正できます。

プロセス

  1. 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に見える瞬間。これが構築するレイアウトです。
  2. そのフレームの静的なCSSを書きます。.scene-contentコンテナは、width: 100%; height: 100%; padding: Npx;とdisplay: flex; flex-direction: column; gap: Npx; box-sizing: border-boxを使用して、シーン全体を埋める必要があります。パディングを使用してコンテンツを内側に押し込みます — コンテンツコンテナにposition: absolute; top: Npxを決して使用しないでください。絶対配置されたコンテンツコンテナは、コンテンツが残りのスペースよりも高いときにオーバーフローします。position: absoluteは装飾用のみに予約します。
  3. gsap.from()でエントランスを追加します — オフスクリーン/非表示からCSSの位置にアニメーションします。CSSの位置がグラウンドトゥルースです。トゥイーンはそこに到達するための旅を記述します。(data-composition-srcを介して読み込まれたサブコンポジションでは、gsap.fromTo()を優先します — references/motion-principles.mdの耐荷重GSAPルールを参照してください。)
  4. gsap.to()でエグジットを追加します — CSSの位置からオフスクリーン/非表示にアニメーションします。

例

/* scene-contentがシーンを埋め、パディングがコンテンツを配置 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* コンテナは任意のシーンサイズ(1920x1080、1080x1920など)を埋めます。
   パディングがコンテンツを配置します。Flex + gapがスペースを処理します。 */

間違い — ハードコードされた寸法と絶対配置:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// ステップ3: それらの位置にアニメーションIN
 tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// ステップ4: それらの位置からアニメーションOUT
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

要素が時間を超えてスペースを共有する場合

要素Aが同じエリアで要素Bが入る前に終了する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置を持つ必要があります。タイムラインの順序付けにより、視覚的に共存することは保証されません — しかし、レイアウトステップをスキップすると、タイミングエラーによって誤って重なるケースを見つけられません。

意図的なオーバーラップと見なされるもの

レイヤー効果(テキストの後ろのグロー、シャドウ要素、背景パターン)とzスタックデザイン(カードスタック、深度レイヤー)は意図的です。レイアウトステップは、意図しないオーバーラップ — 2つの見出しが互いに重なる、統計がラベルを覆う、コンテンツがフレームからはみ出す — をキャッチすることです。

データ属性

すべてのクリップ

属性必須値
idはい一意の識別子
data-startはい秒数またはクリップID参照("el-1", "intro + 2")
data-durationimg/div/コンポジションに必須秒数。ビデオ/オーディオはメディアの長さをデフォルトとします。
data-track-indexはい整数。同じトラックのクリップは重複できません。
data-media-startいいえソースへのトリムオフセット(秒数)
data-volumeいいえ0-1(デフォルトは1)

data-track-indexは視覚的なレイヤリングに影響しません — CSSのz-indexを使用してください。

コンポジションクリップ

属性必須値
data-composition-idはい一意のコンポジションID
data-startはい開始時間(ルートコンポジション:"0"を使用)
data-durationはいGSAPタイムラインの長さよりも優先されます
data-width / data-heightはいピクセル寸法(1920x1080または1080x1920)
data-composition-srcいいえ外部HTMLファイルへのパス
data-variable-valuesいいえサブコンポホスト上のインスタンスごとの変数オーバーライドのJSONオブジェクト

ルートの<html>要素について:

属性必須値
data-composition-variablesいいえ宣言された変数のJSON配列(id/type/label/default) — スタジオ編集UIを駆動し、getVariables()のデフォルトを提供します

コンポジション構造

data-composition-srcを介してロードされるサブコンポジションは、<template>ラッパーを使用します。スタンドアロンコンポジション(メインのindex.html)は<template>を使用しません — data-composition-idのdivを直接<body>に配置します。スタンドアロンファイルで<template>を使用すると、すべてのコンテンツがブラウザから隠され、レンダリングが壊れます。

サブコンポジション構造:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- コンテンツ -->
    <style>
      [data-composition-id="my-comp"] {
        /* スコープ付きスタイル */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // トゥイーン...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

ルートでロード:<div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

変数(パラメータ化されたコンポジション)

同じコンポジションを異なるコンテンツ(タイトル、テーマカラー、価格、キャプション)で、ソースHTMLを編集せずにレンダリングします。

3ステップのパターン:

  1. 宣言 — コンポジションの<html>ルートにdata-composition-variablesで変数を宣言します。各エントリにはid、type(string、number、color、boolean、enumのいずれか)、label、defaultが必要です。列挙型エントリにはoptions: [{value, label}, ...]も必要です。
  2. 読み取り — コンポジションのスクリプト内でwindow.__hyperframes.getVariables()で解決された値を読み取ります。宣言されたデフォルト+インスタンスごとのオーバーライド+CLIオーバーライドのマージされた結果を返します。
  3. オーバーライド — レンダリング時にnpx hyperframes render --variables '{...}'(トップレベル)またはホスト要素のdata-variable-values='{...}'(サブコンポのインスタンスごと)でオーバーライドします。
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"タイトル","default":"こんにちは"},
  {"id":"theme","type":"enum","label":"テーマ","default":"light","options":[
    {"value":"light","label":"ライト"},
    {"value":"dark","label":"ダーク"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# 開発プレビューは宣言されたデフォルトを使用
npx hyperframes preview

# オーバーライドでレンダリング
npx hyperframes render --variables '{"title":"Q4レポート","theme":"dark"}' --output q4.mp4

# またはJSONファイルから
npx hyperframes render --variables-file ./vars.json

サブコンポジションのインスタンスごとの値: 同じgetVariables()が、data-composition-srcを介してロードされたサブコンポ内で機能します。各ホスト要素は独自の値を渡します:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"プロ","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"エンタープライズ","price":"$99"}'
></div>


…

[翻訳用に切り詰められました]

関連スキル