Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames のアニメーション知識をすべて集約したスキル。原子モーションルール、複数フェーズのシーンブループリント、シーン間トランジション、より広範なモーションデザイン技法、そして 7 つのランタイムアダプターをカバーします。

hyperframes-instruct とは?

このスキルは、HyperFrames アニメーションフレームワークにおけるあらゆるモーションタスクを支援するために設計されています。原子ルール(単一フェーズのレシピ)、ブループリント(複数フェーズのシーンテンプレート)、トランジション(シーン間の切り替え)、技法(高度なモーションパターン)、アダプター(GSAP、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU などのランタイム固有 API)を体系的にカバーし、開発者が目的に応じて適切な知識ベースを参照できるようにします。主な使用例としては、2〜4 個のルールを組み合わせてアニメーションを構成する、ブループリントをロードして複雑なコレオグラフィを再利用する、特定のランタイムの API(例:GSAP のイージングや Lottie のプレイヤー制御)を調べる、既存のコンポジションのアニケーションマップを監査する、24 種類のテキストアニメーション効果を使用するなどがあります。HyperFrames のコア原則(一時停止された単一タイムライン、シーク安全、決定論的動作)を前提としており、パフォーマンスと予測可能性を重視したアニメーション制作を実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes-animation

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

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

ドキュメント

プラグインインストール時: セットアップまたは freshness コマンドの前に、このスキルが HyperFrames プラグイン内にある場合は プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。

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
モーションブラー — 要素へのシャッタースミア、および使用すべきでない場合references/motion-blur.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
キャラクターアニメーション(歩行サイクル、マスコット、関節人形、ジェスチャー)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 → 1 つの一時停止タイムライン + 譲れないルール(単一の一時停止タイムライン、data-duration が長さを決定、Math.random / Date.now / performance.now の禁止、有限なルート data-duration なしでの repeat: -1 の禁止、後のシーンのクリップに対するページロード時の gsap.set の禁止、display または生の visibility トゥイーンの禁止、タイムラインは完全に構築された後にのみ登録(document.fonts.ready などの非同期コールバック内での実行を含む))。コアにより、明示的なタイムライン境界での GSAP autoAlpha およびゼロ期間の可視性設定は引き続き許可されます。これらの例外は、クリップ内の非クリップ要素またはラッパーでのみ使用してください。フレームワークは .clip のライフサイクルを所有します。ここで完全な契約を再述する必要はありません。

コアの契約に加えて、アニメーション作成に関する追加事項:

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

スクリプト

node <SKILL_DIR>/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 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). 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`.

sandeshrajbhandari/hyperframes-instruct

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, timeline, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

関連スキル