Communitygithub.com

HyperFrames アニメーション

HyperFrames のアニメーション全知識 — 原子モーションルール、マルチフェーズシーンブループリント、シーン遷移、モーションデザイン技法、7つのランタイムアダプター(GSAP デフォルト、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU)。あらゆるモーション・アニメーションタスクに: 2〜4 ルールを選んで合成、ブループリントを読み込み、ランタイム固有 API を検索。

HyperFrames アニメーション とは?

このスキルは HyperFrames フレームワーク向けのアニメーション知識を網羅した統合リソースです。原子モーションルール、マルチフェーズシーンブループリント、シーン遷移、モーションデザイン技法に加え、7つのランタイムアダプター(GSAP、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU)を提供します。 開発者は 2〜4 のルールを選んで即座に合成するか、既存のブループリントを読み込んで複雑な 4〜5 フェーズの振付を効率的に構築できます。各ランタイムアダプターには専用の API リファレンス(GSAP のイージング/スタッガー、Lottie プレイヤー、Three.js の AnimationMixer など)が用意されています。 HyperFrames ネイティブの設計原則に従い、単一の一時停止タイムライン、シーク安全、決定論的実行を徹底。既存のコンポジションのアニメーションマップを監査するスクリプトや、24 種類の名前付きテキストアニメーションエフェクトも含みます。 Claude Code、Cursor、Codex などの AI エージェントで利用可能で、ルーティングテーブルに従って必要な知識を素早く参照できます。

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

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

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

ドキュメント

HyperFrames アニメーション は何をしますか?

すべてのモーション知識を1つのスキルに統合: ルール(原子レシピ)、ブループリント(マルチフェーズシーンテンプレート)、遷移(シーン間)、技法(広範なモーションデザインパターン)、そしてアダプター(ランタイムごとの API)。

コンポジション契約(データ属性、サブコンポジション、決定論)については hyperframes-core を参照。

デフォルト: 原子ルールの合成

rules-index.md から 2〜4 のルールを選び、単一の一時停止 GSAP タイムラインで結合するだけ。ブループリントから始めるよりも高速で、コード量も少なくなります。

ブループリントを読み込むタイミング

  • シーンが既存のプリデザインされたマルチフェーズテンプレート(ブランドリビール、ソーシャルプルーフなど)に一致し、そのフェーズパイプラインを再利用することで実際の作成時間を節約できる場合
  • 複雑な 4〜5 フェーズの振付の実行可能なグラウンドトゥルースコードが必要な場合

ブループリントは blueprints-index.md にあります。各エントリは blueprints/<id>.md(レシピ)を指します。推測で読まず、シーンレベルのオーケストレーションが必要と判断した後に読み込んでください。

ルーティング

目的参照先
トリガー/タグで原子モーションパターンを選ぶrules-index.md
1つのルールの完全な HTML / CSS / GSAP レシピを読むrules/<name>.md
マルチフェーズシーンテンプレートを選ぶblueprints-index.md
1つのブループリントの完全なレシピを読むblueprints/<id>.md
シーン遷移を作成する(CSS 駆動、2つのクリップ間)transitions/overview.md、transitions/catalog.md
広範なモーションデザイン技法を調べるtechniques.md
既存のコンポジションのアニメーションマップを分析するscripts/animation-map.mjs
GSAP API — タイムライン / トゥイーン / 位置パラメータadapters/gsap.md
GSAP — ドロップインエフェクトレシピrules/gsap-effects.md
GSAP — トランスフォーム / パフォーマンスadapters/gsap-transforms-and-perf.md
GSAP — イージング / スタッガーadapters/gsap-easing-and-stagger.md
GSAP — タイムライン / ラベルadapters/gsap-timeline-and-labels.md
Lottie / dotLottie(After Effects 書き出し、window.__hfLottie)adapters/lottie.md
Three.js / WebGL(3D シーン、AnimationMixer、hf-seek)adapters/three.md
Anime.js(window.__hfAnime)adapters/animejs.md
CSS キーフレーム(animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API(element.animate()、currentTime シーク)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu、WGSL、コンピュートパイプライン)adapters/typegpu.md
HTML-as-texture + WebGL/GLSL ポストエフェクト(drawElementImage でライブ DOM キャプチャ)adapters/html-in-canvas-patterns.md
名前付きテキストアニメーションエフェクト(外部 animate-text スキルの 24 個の ID)adapters/animate-text.md

ランタイムの選択

  • GSAP はモーション作業の 95% でデフォルト — タイムラインオーケストレーション、トランスフォーム、イージング、スタッガーをカバー。このスキルのすべての原子ルールは GSAP ベースです。
  • Lottie はアセットに独自のプリベイクタイムラインがある場合(通常 After Effects 書き出し)。
  • Three.js は 3D シーン、カメラモーション、シェーダ駆動ビジュアル向け。
  • Anime.js は GSAP がオーバーキルな軽量トゥイーン向け。
  • CSS は単純な繰り返しモチーフ、装飾、きらめき — JavaScript アニメーションコストなし。
  • WAAPI は GSAP 依存なしのネイティブブラウザキーフレーム向け。
  • TypeGPU / WebGPU は GPU レンダリングキャンバス向け(パーティクル、液体ガラス、カスタムシェーダー)。

複数のランタイムが1つのコンポジション内で共存できます。各ランタイムはそのインスタンスをランタイム固有のグローバルに登録し、HyperFrames が1パスですべてをシークできるようにします。

重要な制約

前提条件: hyperframes-core → 譲れないルール(単一の一時停止タイムライン、data-duration が長さを決定、Math.random / Date.now / performance.now 不使用、repeat: -1 不使用、後続シーンクリップへのページロード時の gsap.set 不使用、display や生の visibility トゥイーン不使用、async / setTimeout / Promise 内でのタイムライン構築不使用)。GSAP の autoAlpha と明示的なタイムライン境界でのゼロ期間可視性設定はコアで許可されます。これらの例外はクリップ以外の要素またはクリップ内のラッパーにのみ使用し、.clip ライフサイクルはフレームワークが管理します。ここで完全な契約を再述する必要はありません。

コアの契約に追加するアニメーション作成上の注意:

  • 事前計算されたレイアウト定数 — トゥイーン時に getBoundingClientRect() から位置を導出しないでください。トゥイーン時の DOM 計測はレンダラーが並列でサンプリングするため非同期になります。座標はコンポジション設定時に一度計算し、再利用します。
  • 空間モーションには GSAP トランスフォームエイリアスのみを使用(x、y、scale、rotation)。コアの許可リストは非空間プロパティのトゥイーンとして opacity / color / backgroundColor / borderRadius も許可しますが、レイアウト変更に width / height / top / left を使用することは決してありません。

スクリプト

node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

window.__timelines に登録されているすべての GSAP タイムラインを読み取り、トゥイーンを列挙し、バウンディングボックスをサンプリングし、フラグを計算し、animation-map.json を出力します。作成後に振付の監査(デッドゾーン、スタッガーの一貫性、ライフサイクル警告)に使用します。

animation-map.mjs はまず現在のプロジェクトからヘルパーパッケージを解決し、次にバンドルされた HyperFrames パッケージバージョンをブートストラップできます。スキルをバンドルされた CLI/スキルインストールの外部で実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ、HYPERFRAMES_SKILL_PKG_VERSION=<version> を設定してください。

関連項目

  • hyperframes-core — コンポジション構造、データ属性、サブコンポジション、決定論的レンダリング契約
  • hyperframes-creative — パレット、タイポグラフィ、ナレーション、ビート計画(アニメーション以外のクリエイティブディレクション)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / 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

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

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

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`.

関連スキル