Communitygithub.com

MattiaIppoliti/tia-skills

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

tia-skills とは?

このスキルは、HyperFramesフレームワーク向けのアニメーション知識を包括的に提供します。原子モーションルール(ルールインデックスから2〜4つ選択して合成)、マルチフェーズシーンブループリント(ブランドリビール、ソーシャルプルーフなど)、CSS駆動のシーン間遷移、幅広いモーションデザイン技法、そしてGSAP、Lottie、Three.js、Anime.js、CSSキーフレーム、Web Animations API、TypeGPUという7つのランタイムアダプターをカバーします。各アダプターには専用のAPIドキュメント(GSAPのイージング/スタッガー、Lottieプレイヤー、Three.jsミキサーなど)が用意されています。また、`animation-map.mjs`スクリプトを使用して既存のコンポジションのアニメーションマップ(振付)を監査したり、24種類の名前付きテキストアニメーションエフェクトを適用することも可能です。HyperFramesネイティブの設計として、単一の一時停止タイムライン、シーク安全性、決定論的レンダリングを前提としています。現在の出力フレームワークはRemotion + Reactですが、モーションクラフトの知識(タイミング、イージング、ルール名、ブループリント)は引き続き有効です。コード例は旧ランタイム(HTML + 一時停止GSAPタイムライン)向けのため、Remotionプロジェクトへの貼り付け時には注意が必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-animation

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

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

ドキュメント

⚠ コントラクトステータス: クラフトは現行、コードは旧式

このスタックの出力フレームワークは Remotion + React (/hyperframes-core) です。 ここにあるモーションクラフトは依然として有効です:タイミング、イージングの選択、動作の形状、名前付きルールとブループリント。 コードは無効です:例とアダプターは、廃止されたHTML + 一時停止GSAPタイムラインランタイム向けに書かれています。

読みながら翻訳してください:

こちらの記述Remotionでは
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), 目視で調整
window.__timelines[id] の一時停止タイムラインなし;すべての値は useCurrentFrame() の関数
クリップの data-start / data-duration<Sequence from> / durationInFrames(フレーム単位)
CSSキーフレームまたはトランジションフレームから導出したインライン style(CSSアニメーションはレンダリングされない)

このスキルの例をそのままRemotionプロジェクトに貼り付けないでください。

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 スキルで24ID)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パッケージバージョンをブートストラップできます。HYPERFRAMES_SKILL_PKG_VERSION=<version> は、バンドルされたCLI/スキルインストールの外部でスキルを実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ設定します。

関連項目

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, 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 code.

関連スキル