Communitygithub.com

Avinash1286/pendent

HyperFrames アニメーションに関する全知識 — アトミックモーションルール、マルチフェーズシーンブループリント、シーン遷移、幅広いモーションデザイン手法、さらに7つのランタイムアダプター(GSAP デフォルト、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU)をカバー。あらゆるモーション・アニメーションタスクに使用可能。

pendent とは?

このスキルは、HyperFrames フレームワーク向けに特化した包括的なアニメーション知識ベースです。アトミックモーションルール、マルチフェーズシーンブループリント、シーン遷移、モーションデザイン手法、そして7つのランタイムアダプター(GSAP、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU)をカバーします。開発者は、シンプルなアニメーションには2〜4個のルールを組み合わせるか、複雑なシーンには既存のブループリントをロードすることで、効率的にアニメーションを構築できます。また、ランタイム固有のAPI(GSAPのイージング、Lottieプレーヤー、Three.jsミキサーなど)の参照や、既存コンポジションのアニケーションチェック、24種類のテキストアニメーション効果もサポートします。HyperFrames ネイティブとして、単一の一時停止タイムラインに依存し、シークセーフで決定論的な動作を保証します。ルールは GSAP ベースで提供され、各ランタイムは特定のグローバルオブジェクトを介してフレームワークと統合されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Avinash1286/pendent/tree/HEAD/film/docs

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

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

ドキュメント

HyperFrames アニメーション

すべてのモーション知識を1つのスキルに集約:ルール(アトミックレシピ)、ブループリント(マルチフェーズシーンテンプレート)、遷移(シーン間)、手法(より広範なモーションデザインパターン)、およびアダプター(ランタイムごとのAPI)。

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

デフォルト:アトミックルールを組み合わせる

rules-index.md から2~4個のルールを選び、それらを単一の一時停止したGSAPタイムラインで結合するだけで完了です。この方法はブループリントから始めるよりも高速で、生成されるコードも少なくなります。

ブループリントをロードするケース

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

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

ルーティング

目的参照先
トリガー/タグによるアトミックモーションパターンの選択rules-index.md
ルールの完全なHTML/CSS/GSAPレシピを読むrules/<name>.md
マルチフェーズシーンテンプレートの選択blueprints-index.md
ブループリントの完全なレシピを読む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測定は、レンダラーが並行してサンプリングするため同期が取れなくなります。コンポジションセットアップ時に1度だけ座標を計算し、再利用してください。
  • 空間モーションは 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

関連スキル