Communitygithub.com

HyperFrames コアスキル

HyperFrames のコンポジション構成契約 — レンダリング可能なプロジェクトを1つ構築します。コンポジション構造、`data-*` タイミング属性、`class="clip"`、トラック、サブコンポジション、変数、フレームワーク所有のメディア再生、決定論的レンダリングルール、バリデーションをカバーします。また、Tailwind プロジェクトと STORYBOARD.md / SCRIPT.md 計画形式も対象とします。コンポジションHTMLを作成する前に読んでください。

HyperFrames コアスキル とは?

このスキルは、HyperFrames フレームワーク内でビデオコンポジションを構築するための公式な技術契約です。HyperFrames は HTML ファイルからビデオをレンダリングし、DOM で宣言されたタイミング属性 (`data-*`) と、シーク可能でフレームワークがメディア再生を所有するアニメーションランタイムを使用します。このスキルは、スタンドアロンの `index.html` コンポジションと、`<template>` でラップされたサブコンポジションの2つのルート形式、タイムラインの登録方法、コンポジション全体にわたる一意の ID 管理、決定論的レンダリングルール(レンダリング時間のクロック禁止、許可されるアニメーションプロパティ、レイアウトとテキストフィット)、バリデーションコマンド(`npx hyperframes check`、`snapshot`、`preview`、`render`)など、すべての重要な構築ルールをカバーしています。さらに、BRIEF.md、STORYBOARD.md、SCRIPT.md などの計画形式や、他の HyperFrames スキル(アニメーション、クリエイティブ、CLI、レジストリ)への参照を提供します。このスキルは、HyperFrames 向けのコンポジション HTML や計画文書を作成するあらゆる開発者や AI エージェントにとって必須であり、サイレントバグを防ぎ、すべてのコンポーネントがフレームワークのレンダリングエンジンと正しく統合されることを保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-core

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

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

ドキュメント

HyperFrames コア

HyperFrames は HTML からビデオをレンダリングします。コンポジションとは、その DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生をフレームワークが所有する HTML ファイルです。

このスキルは技術契約 — 1つの hyperframes プロジェクトを構築する方法です。以下の本文が構築ガイドです;トピック別の詳細は references/ にあります(次にインデックスを参照)、必要に応じて読んでください。その他の関心事は、兄弟ドメインスキル — hyperframes-animation、hyperframes-creative、media-use、hyperframes-cli、hyperframes-registry にあります。/hyperframes の機能マップに各スキルの対象範囲が記載されています。

リファレンス

ファイル読む目的…
references/minimal-composition.md最小のレンダリング可能なコンポジションスケルトンから始める
references/composition-patterns.mdモノリシック vs モジュラーを選択する;モジュラー index.html を構造化する;サブコンポジションのアーキタイプを選ぶ
references/data-attributes.md任意の data-*(ルート / クリップ / サブコンポホスト / レガシーエイリアス)を調べる;class="clip" を使用する
references/tracks-and-clips.mddata-track-index を選択する;同じトラックの重なり / z-index を処理する;クリップを別のクリップに対してタイミング調整する
references/sub-compositions.mdサブコンポジション(ホスト属性、<template>、インスタンスごとの変数)を配線し、その内部でアニメーションさせる
references/variables-and-media.md変数を宣言する;<video>/<audio> を配置し、ボリューム、トリムを設定する
references/determinism-rules.mdシーク可能なタイムラインを構築する;決定論の禁止事項;アニメーションプロパティ許可リスト;レイアウト / テキストフィット
references/full-screen-motion.md共有背景を使用して全画面モーションを作成する
references/storyboard-format.mdSTORYBOARD.md 計画(および解析されたマニフェスト)を作成する
references/review-loop.mdライブボードで plan → sketch → build のレビューパスを実行する — すべてのストーリーボード計画ワークフローで共有
references/production-loop.md承認された計画を納品されたビデオにする — ステージの依存関係(オーディオ、フレーム、アセンブリ、トランジション、キャプション、検証、納品)に従い、自由形式のビルドが直接続く
references/brief-contract.mdブリーフの基本ルール — モードの導出(協調 / 自律)、共有フィールドレジストリ、質問の不変条件(質問自体は /hyperframes → インテント層に存在)
references/brief-format.mdBRIEF.md を作成する — ワークフローのセットアップが書き、後続のすべてのステップが読む確定されたインテント文書
references/script-format.mdオプションの SCRIPT.md ロックされたナレーションを作成する
references/subagent-dispatch.mdサブエージェントディスパッチ動詞(並列ファンアウト / バックグラウンド / 待機)をハーネスにマッピングする
references/tailwind.mdTailwind v4 プロジェクトで作業する(init --tailwind;ランタイム契約は Studio の v3 とは異なる)

アニメーションランタイムの詳細(GSAP API、Lottie、Three.js など)については、hyperframes-animation → adapters/<runtime>.md を参照してください。

コンポジションの構築

2つのルート形式(互換性なし)

  • スタンドアロン(トップレベルの index.html) — ルート <div data-composition-id="…"> が <body> 内に直接配置される。<template> ラッパーは不要(ラップするとすべてのコンテンツが隠れ、レンダリングが壊れます)。
  • サブコンポジション(data-composition-src で読み込まれる) — ルートは必ず <template> でラップする必要があります。

⚠ 転送ルール:ランタイムは <template> の内容のみをクローンします;外側のもの(<head> のスタイル/スクリプトを含む)はすべて破棄されます — <style>/<script> はテンプレート内に配置してください。 ⚠ ホストIDルール:ホストスロットの data-composition-id は、内部テンプレートの data-composition-id および window.__timelines["<id>"] キーと完全に一致する必要があります — -mount/-slot/-host サフィックスは付けないでください。

ファイル構造、ホスト配線、およびプリレンダリングチェックリスト → references/sub-compositions.md。

ルートはサイズ指定が必要(サイレントレイアウトバグ)

スタンドアロンルートには、明示的なサイズ指定のボックス(width/height をpxで)が必要であり、height:100% 要素までのすべての祖先が解決された高さを持っている必要があります — そうしないと、flex/100% の子要素が約0に縮小し、コンテンツが左上隅に詰まります。自動化されたゲートだけに頼らずにこれを検出しないでください;スナップショットを検査してください。スケルトン → references/minimal-composition.md。

1つの一時停止タイムライン

各コンポジションは、ページ読み込み時に同期的に構築された、window.__timelines["<id>"](キー = ルート data-composition-id)に正確に1つの gsap.timeline({ paused: true }) を登録します。レンダリング期間 = ルート data-duration,タイムラインの長さではありません。サブタイムラインを手動でホストにネストしないでください。完全な契約(非GSAPランタイムを含む)→ references/determinism-rules.md + hyperframes-animation/adapters/。

譲歩できないルール(自動化ゲートが見逃す可能性のあるサイレントバグ)

ここに提示されています;完全な根拠はリンク先のリファレンスにあります。違反しないでください:

  • レンダリング時間のクロック / シードされていない Math.random / ネットワーク / 入力状態は禁止;repeat: -1 は禁止(有限カウントを使用)。→ determinism-rules.md
  • ビジュアルプロパティ許可リストのみをアニメーション化;display や生の visibility をトゥイーンしないでください。GSAP autoAlpha とゼロ期間タイムラインバウンダリ設定のみが可視性の例外であり、クリップ以外の要素またはクリップ内のラッパーにのみ適用されます。フレームワークのみが .clip の可視性を制御します。ページ読み込み時に後続シーンのクリップに対して gsap.set を行わないでください。→ determinism-rules.md
  • 本文テキストに <br> は禁止;変換された要素はブロックレベルでサイズ指定されている必要があります;パルスする絶対配置デコレーティブはピーククリアランスが必要です。→ determinism-rules.md
  • <video>/<audio> はホストルートの直接の子でなければなりません(サブコンポ <template>/ラッパー内には絶対に配置しない);フレームワークが再生を所有します。→ variables-and-media.md
  • すべての id はアセンブルされたページ全体で一意でなければなりません;サブコンポ内では、IDにコンポジションIDをプレフィックスとして付けます(#<id>-hero)。重複した <video>/<img> ID は空白でレンダリングされます — プロデューサーは getElementById でフレームを注入し、ファイルをまたがる重複は lint をすり抜けます。→ composition-patterns.md
  • 全画面シーンの塗りつぶしは、全面にわたる子要素(position:absolute; inset:0)に配置し、決してコンポジションルート自体には配置しないでください — プロデューサーのフレーム合成はルート要素自体の background をドロップする可能性があり(フレームは黒でレンダリングされます)、プレビュー/snapshot で正しく表示されていても同様です。→ composition-patterns.md

既存のコンポジションの編集

  • 最初にファイルを読んでください。無関係なタイミング、トラック、ID、変数、メディアパスは保持してください。
  • 既存のコンポジションIDとタイムラインキーに一致させてください。
  • クリップを追加する:重複しない data-track-index を選択するか、意図的に周囲のタイミングを調整してください。
  • 任意のコンポジション要素に対する data-hidden は、プレビューとレンダリングの両方でその要素を非表示にし、時間ウィンドウをオーバーライドします;これは非破壊的/可逆的であり、Studioのタイムラインの目のアイコンで切り替えられます。
  • サブコンポジションを追加する:ホストを配線する前に、その内部の data-composition-id を確認してください。

バリデーション

コマンドの詳細については hyperframes-cli を使用してください

  • npx hyperframes check がパスする(lint、ランタイム、レイアウト、モーション、コントラストにわたって0の検出結果)
  • サブコンポジションを含むプロジェクト:npx hyperframes snapshot --at <midpoints> を実行し、各フレームを目視確認する
  • レビュー用に npx hyperframes preview(ユーザーはStudioのタイムラインで何でも編集できます)
  • ユーザーが承認した後にのみ npx hyperframes render

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

dbillion/hermes-skills-public

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

関連スキル