Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames のコンポジションで、パンチイン、パンチアウト、ズーム、リフレーム、ケン・バーンズ処理、カメラ移動、ビジュアルマッチ / ホイップハンドオフ、その他のシークセーフな 2D/3D キーフレームが必要な場合に使用します。また、GSAP、CSS キーフレーム、Anime.js、WAAPI、FLIP、パス、マスク、SVG モーフ/ドロー、テキストトレイル、3D 深度、`hyperframes keyframes` 診断にも対応します。幅広いシーン戦略、ブランドデザイン、メディア調達、キャプション、一般的な動画計画には使用しないでください。

hyperframes-instruct とは?

このスキルは、HyperFrames エコシステム内で、シークセーフかつ決定論的なキーフレームアニメーションを作成および検証するためのものです。GSAP、CSS キーフレーム、Anime.js、WAAPI などの主要なアニメーションライブラリに対応し、ズーム、パン、トランジション、SVG モーフィング、3D 深度、テキストアニメーションなどの複雑な動きを実現します。このスキルの核心は、可視状態の正確な契約を定義することにあり、隠れたヘルパー状態や非決定的なタイミングに依存しません。`hyperframes check` や `hyperframes keyframes` などの CLI ツールを使用して、ターゲットの特定、明示的な停止、パス、合成の親子動作などを検証できます。このスキルは、純粋なタイムライン編集(`/hyperframes-core` が担当)と視覚的なモーションを分離し、アニメーションがコンポジションのタイムラインとソース範囲に安全にシークできることを保証します。開発者は、このスキルを使用して、視覚的なモーションにキーフレームを適用し、シーンの戦略やメディアの調達には異なるスキルを適用するという、明確な編集境界を維持する必要があります。

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

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

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

ドキュメント

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

HyperFrames キーフレーム

キーフレームはポーズ契約です:可視状態、連続した被写体の同一性、シークセーフなランタイム、検証済みのピクセル。

幅広いシーンレシピには hyperframes-animation を使用してください。完全なコマンドドキュメントには hyperframes-cli を使用してください。実装メカニズム(視覚スタイルではない)を選択する場合にのみ references/keyframe-patterns.md を使用してください。

クリエイター編集境界

キーフレームは視覚的なモーションを担当し、クリップの組み立ては担当しません。ソース範囲のハードカット、トリム、スプライス、並べ替えは /hyperframes-core に属します:保持する範囲ごとに 1 つのメディア要素を作成し、data-start と data-duration で配置し、data-media-start でソースオフセットを選択します。隣接する範囲はハードカットになります。クロスフェードは、異なるトラック上の重複するクリップと視覚的な不透明度キーフレームを使用します。サウンドフェードには /hyperframes-audio を使用します。

クリエイターのリクエスト正確なメカニズム
パンチイン / パンチアウトクリップ内の非タイミングのビジュアル/クロップラッパーで scale と x/y またはパーセンテージ変換をキーフレーム化します。ハードパンチにはセット/ショートトゥイーン、スムーズな移動にはトゥイーンを使用します。
スムーズなマルチステートズームまたはリフレーム1 つの被写体ラッパーを維持し、複数のズーム/リフレーム状態を、セグメントごとのイージングを持つポーズラダーとして作成します。
パン、リフレーム、またはケン・バーンズカメラ移動ラッパーの移動とスケールをアニメーション化します。ジオメトリは作成されます。これは顔追跡や自動セマンティックリフレームではありません。
チェーンされたカメラ移動1 つの登録済みシークセーフタイムライン上で、ラベル付けされたトランスフォームビートをチェーンします。
マッチカットまたはホイップパン/hyperframes-animation がビジュアルハンドオフを担当します。/hyperframes-registry がプリミティブを提供します。キーフレームは、作成されたジオメトリ、方向、速度を維持します。自動マッチングフレーム検出はありません。
クロップとマスクリフレーム内部ビジュアルラッパーで clip-path またはマスクを補間して、ソース時間を変更せずにクロップ/リフレームします。ポリゴンキーフレームはポリゴン/マスクトランジションを形成できます。
方向性ワイプカットまたはアイリス/リビールカット重複するビジュアルクリップ間でマスク/クリップ境界をアニメーション化します。/hyperframes-animation がハンドオフの振り付けを担当します。
分割画面ハンドオフコアによって配置された両方のビジュアルクリップを維持し、それらの内部クロップ/マスクラッパーと区切りジオメトリをキーフレーム化します。
一定のソース再タイミング/hyperframes-core は、レンダリングセーフなピクチャとピッチ保存されたサウンドのために、正規化された data-playback-rate(0.1..10)を担当します。これはメディア要素全体で一定です。
ソース速度ランプ<video>/<audio> の data-automation 内の rate レーン(クリップ秒単位の t、0.1..10 の v、ログ補間)。これは一定のレートよりも優先されます。
フリーズ / ホールド視覚的なポーズ、最終ソースフレーム、または完了したサブコンポジションは保持できます。任意のソース途中フリーズはサポートされていません。静止/派生セグメントを前処理し、それを独自のクリップとして配置してから、別のソース範囲で再開します。

ピクチャとサウンドを一緒に編集する場合は、/hyperframes-core、視覚的なモーション用のこのスキル、および配置されたトラック上のフェード、クロスフェード、ボリュームオートメーション、ダッキング/カーブ、またはエフェクト用の /hyperframes-audio をロードします。

視覚的なトランジションまたはクロップ処理は、一時的なソーストリムまたはスプライスではありません。/hyperframes-core がタイムライン、クリップタイミング、およびソース範囲を担当します。キーフレームは、それらのクリップ内のラッパー上の可視ハンドオフまたはクロップのみをアニメーション化します。コピー可能な組み合わせピクチャ/サウンドレシピについては、/hyperframes-core → references/creator-editing-recipes.md を使用してください。

手順

  1. アニメーション化する被写体、可視状態、最終状態、およびランタイムを特定します。
  2. プロンプトを証明する最小のメカニズムを選択します。メカニズムが不明な場合にのみ references/keyframe-patterns.md を読んでください。
  3. 宣言されたランタイムでシークセーフなキーフレームを作成します。ビルドが完了した後にのみランタイムインスタンスを登録してください。document.fonts.ready 内でのビルドは問題ありません。
  4. hyperframes check(lint を実行)、hyperframes keyframes、1 つのフォーカスされた --shot、およびプルーフ時間でのスナップショットで検証します。
  5. プルーフが失敗した場合は、ソースのキーフレームを修正し、レンダリングする前に、失敗した最小の診断を再実行します。

契約

  • 移動する被写体に名前を付けます。
  • 最終状態を含む、意図した動きを証明するために必要なポーズに名前を付けます。
  • 隠れたヘルパー状態ではなく、可視チャンネルをキーフレーム化します。
  • 連続性が重要な場合は、オブジェクトの同一性を維持します。
  • 意図した動きが置換またはディゾルブである場合にのみクロスフェードします。
  • 読み取り可能またはセマンティックな状態を、見えるのに十分な長さ保持します。
  • 最終フレームはアニメーションの一部であり、後処理ではありません。
  • 要求されない限り、静止状態にリセットしないでください。
  • 要求されない限り、黒で終了しないでください。
  • スターターシーンを編集する場合は、再設計を要求されない限り、レイアウト、コピー、アセット、色、および最終状態を維持します。

ランタイムルール

GSAP:

  • ページロード時または document.fonts.ready 内でビルドし、ビルドが完了した後にのみ登録します
  • gsap.timeline({ paused: true }) を使用します
  • window.__timelines[compositionId] として登録します
  • レジストリキーは data-composition-id と一致している必要があります
  • レンダリングクリティカルなモーションに tl.play() を呼び出さないでください
  • 繰り返しは有限に保ちます

CSS キーフレーム:

  • 有限の期間と反復回数
  • 決定論的な遅延
  • animation-fill-mode: both
  • タイミングがクリップに属する場合は data-start を使用します

Anime.js:

  • 同期的に作成します
  • autoplay: false
  • 有限の期間とループ
  • すべてのインスタンスを window.__hfAnime にプッシュします

WAAPI:

  • 有限の duration
  • fill: "both"
  • 決定論的な構築
  • テキストサーフェスは WAAPI をリストしません。--shot(WAAPI をシークします)とスナップショットで検証します

レンダリングクリティカルなモーションに絶対に使用しないでください:

  • Date.now()
  • performance.now()
  • シードされていない Math.random()
  • ホバー/スクロールトリガー
  • タイマー
  • 非同期ビルドが完了する前に登録されたタイムライン
  • 未登録の requestAnimationFrame
  • 無限ループ

GSAP スケルトン

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

セマンティック状態にはラベルを使用します。チェーンされた遅延の代わりに位置パラメータを使用します。同じプロパティに後で触れる from()/fromTo() トゥイーンには immediateRender: false を使用します。

キーフレーム形式

  • 配列キーフレーム:ステップごとの期間/イージングを持つポーズラダー。
  • パーセンテージキーフレーム:1 つのトゥイーン内の正確なタイミング。
  • プロパティ配列:コンパクトなマルチストップ変更。
  • 各ストップが独自のイージングを持つ場合、親で ease: "none"。
  • すべてのセグメントが同じ感触を共有する必要がある場合の easeEach。

例から数値の距離やタイミングをコピーしないでください。実際のコンポジションのジオメトリと期間から導き出します。

2 つのボックス間を移動する 1 つの被写体の場合は、1 つの連続したトランスフォームトゥイーンまたは FLIP を優先します。視聴者が明確なビートを感じるべき場合にのみ、x/y/scale を複数のイージングされたキーフレームに分割します。すべてのセグメントは速度を変更し、ひっかかりとして読み取られる可能性があります。

チャンネル

コンポジター/ビジュアルチャンネルを優先します:x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、マスク、CSS 変数、SVG パス/ダッシュ値、カメラトランスフォーム、シェーダーユニフォーム。

レイアウト/ライフサイクルチャンネルは避けてください:top/left/right/bottom、width/height、margin/padding、display、visibility、後期 DOM 作成、被写体の動きを行うヘルパーオーバーレイ。

可視性の変更には、登録済みのシーク可能な GSAP タイムライン上の autoAlpha、または明示的な境界でのゼロ期間の tl.set() を使用します。クリップ以外の要素またはクリップ内のラッパーのみをターゲットにします。.clip 自体をターゲットにしないでください。生の visibility を期間トゥイーンしたり、display をトゥイーンしたりしないでください。

メカニズムの選択

プロンプトを証明する最小のメカニズムを選択します:

ニーズメカニズム
同じ被写体がボックスまたは階層を変更する共有要素 / FLIP
被写体が可視ルートを移動するパス移動
ストロークが成長またはトレースするストローク描画
形状が別の形状になる形状補間
リビール境界が可視であるクリップ、マスク、またはシェーダーユニフォーム
多くのアイテムが順序に従って移動するスタガー / インデックス付き遅延
テキスト自体が移動する行、単語、文字、またはバンドの細分化
サーフェスが曲がる、伸びる、またはクロップされる親/子カウンタートランスフォーム
UI に状態がある明示的なステートマシン
シーンに深度があるDOM 3D、Three.js、または WebGL カメラ/オブジェクトキーフレーム

メカニズムは組み合わせることができますが、それぞれがアイデアを明確にする必要があります。装飾は証明ではありません。

タイミング

  • 原因または方向を明確にする場合にのみ予告。
  • 加速は静止を離れます。
  • ピークプルーフはメカニズムを間違いなく示します。
  • フォロースルーはエネルギーと方向を伝えます。
  • 被写体が弾力性または触感を感じるべき場合にのみオーバーシュート。
  • 一定速度のパス移動は通常 ease: "none" が必要です。
  • 離散的な UI 状態は通常、鋭いイーズアウトが必要です。
  • 繰り返される要素は、同一のタイミングではなく、順序付けられたオフセットが必要です。
  • 最終ロックアップは、トランジションポーズよりも長いホールドが必要です。
  • 滑らかさは、同じ被写体での連続した速度を意味します。
  • オーバーラップが意図的で検証されていない限り、同じトランスフォームプロパティを書き込むトゥイーンをオーバーラップさせないでください。
  • 同じヒーローサーフェスがスケーリングまたは移動している間に、大きな clip-path/マスクの変更をアニメーション化しないでください。メインの移動が落ち着いた後に入れ子のリビールを使用します。

テキスト

ラインボックス、単語間隔、可読性、および最終的なフィットを維持します。テキストが内部で移動する場合は、テキストの周りの装飾だけでなく、グリフまたはマスクされたバンドを移動します。読み取り可能なフレームをスナップショットします。

SVG

ストロークの成長には DrawSVGPlugin、次に stroke-dasharray/stroke-dashoffset を優先します。形状補間には MorphSVGPlugin を優先します。必要に応じてプリミティブをパスに変換し、複雑なシルエットをより単純な部分に分割します。

3D

スケールだけでは疑似深度です。安定した親にパースペクティブ、transform-style: preserve-3d、z 移動、回転、カメラ/ワールドモーション、オクルージョン、およびオブジェクトが交差するときのレイヤー順序を使用します。

深度関係を公開する 1 つまたは 2 つの診断角度を使用します。角度付きプルーフが深度の交差を示さない場合は、z/カメラ/オクルージョンを改善します。

キャンバス / WebGL

決定論的な状態を通じて、カメラ位置、カメラターゲット、オブジェクトトランスフォーム、マテリアル不透明度、シェーダーユニフォーム、およびポストプロセス強度をキーフレーム化します。 HyperFrames 時間からレンダリングします。マーカーボックスは内部のキャンバスモーションを認識できないため、--ghost を使用します。

CLI プルーフ

npx hyperframes check
npx hyperframes keyframes .

(以下、スキルマークダウン全体の翻訳について、指定された元の内容をすべて翻訳します。長いため、上記の翻訳スタイルに従って、すべてのセクション、リスト、テーブル、コードブロックを適切に日本語化して出力します。コードブロック内とインラインコードは英字のままです。)

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

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.

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

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.

関連スキル