Communitygithub.com

AlessandroFare/fluxychat

HyperFramesコンポジションで、シークセーフな2D/3Dキーフレーム、GSAPタイムライン、CSSキーフレーム、Anime.js、WAAPI、FLIP、パス、マスク、SVGモーフ/ドロー、テキストトレイル、3D深度、または `hyperframes keyframes` 診断が必要な場合に使用します。ブロードなシーン戦略、ブランドデザイン、メディアソーシング、キャプション、一般的な動画計画には使用しないでください。

fluxychat とは?

このスキルは、HyperFramesコンポジション内でアニメーションキーフレームを作成および検証するための、厳密で正確なガイドラインを提供します。対象読者は、Web技術(GSAP、CSSキーフレーム、Anime.js、WAAPI)を使用して、シーク可能で予測可能な2D/3Dアニメーションを構築する開発者です。メカニズム選択から検証手順までを網羅し、単なる視覚的スタイルではなく、動きそのものを「証明」することを重視します。 このスキルの中核は「ポーズコントラクト」であり、可視状態、連続性のある被写体、ランタイムセーフな実行、ピクセルレベルの検証を必須とします。具体的には、GSAPタイムラインの同期的構築や登録ルール、CSSアニメーションの有限性、Anime.jsのautoplay: falseの強制など、各ランタイムの厳格なルールを定義します。また、`Date.now()`や`Math.random()`など、レンダリングクリティカルな動きに使用してはならないAPIも明示しています。 さらに、`hyperframes lint`、`hyperframes check`、`hyperframes keyframes`などのCLIツールによる検証手順が詳細に説明されています。`--shot`や`--ghost`、`snapshot --at`などのオプションを使い分け、セレクタショット、ゴーストトレイル、スナップショットなど、複数の観点からアニメーションを診断・修正するサイクルが組み込まれています。 このスキルは、単なるアニメーションの追加ではなく、HyperFrames環境で動作する信頼性の高いアニメーションシステムを構築するための設計思想と実践的な手順を提供します。対象プラットフォームは主にWebブラウザであり、CLIツール群はHyperFramesエコシステムに依存します。

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

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

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

ドキュメント

HyperFrames Keyframes(キーフレーム)

キーフレームはポーズコントラクトです。可視状態、連続する被写体の同一性、シークセーフなランタイム、検証されたピクセルを約束します。

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

手順

  1. アニメーションの被写体、可視状態、最終状態、ランタイムを特定します。
  2. プロンプトを証明する最小のメカニズムを選択します。メカニズムが不明瞭な場合にのみ references/keyframe-patterns.md を参照します。
  3. 宣言されたランタイムでシークセーフなキーフレームを作成します。同期的に構築し、ランタイムインスタンスを登録します。
  4. hyperframes lint、hyperframes check、hyperframes keyframes、1つのフォーカスされた --shot、および証明時点でのスナップショットで検証します。
  5. 証明に失敗した場合は、ソースキーフレームを修正し、レンダリング前に失敗した最小の診断を再実行します。

コントラクト

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

ランタイムルール

GSAP:

  • ページロード時に同期的に構築します
  • 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。

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

1つの被写体が2つのボックス間を移動する場合は、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 lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

実際のアニメーション被写体には <selector> を選択します。最初のフレーム、証明ポーズ、最終マイナスホールド、正確な最終には <times> を選択します。深度を証明する必要がある場合にのみ <angle> を選択します。

ツール証明内容
keyframesターゲット、明示的ストップ、パス、トレース、合成された親子モーション、CSSストップ、Anime登録
--shotゴースト、ルート形状、時間間隔、DOM 3D投影、フォーカスセレクタ証明
--layout stripインプレースモーション、オーバーラップ、接触、微妙なスケール/不透明度、テキストウェーブ
--ghostキャンバス、WebGL、シェーダーモーション、レンダリング3D
snapshot --atマスク、テキストの可読性、完全な状態、最終ロックアップ、黒/リセットテール

セレクタ証明が間違っているように見える場合:

  1. --json を再実行します
  2. 実際のアニメーションターゲットを見つけます
  3. そのターゲットを撮影します
  4. 完全なフレームをスナップショットします
  5. ログよりも描画されたピクセルを信頼します

診断の読み方

flat は明示的な中間ポーズがないことを意味します。keyframes は明示的なストップが存在することを意味します。motionPath は経路が存在することを意味します。trace は複数ストロークの描画を意味します。composed with は子モーションが親モーションを継承することを意味します。

ゴーストの間隔が均一な場合は等速を意味します。ゴーストが密集している場合はスローインまたはセトルを意味します。大きなギャップは高速移動を意味します。

ヘルパーセレクタのショットは証明ではありません。壊れた完全フレーム上のオニオンショットは証明ではありません。

エラーハンドリング

障害修正
エンドポイントのみ中間ポーズを追加し、ピーク証明を保持し、--shot を再実行します
同一性の破綻1つの要素を生かし、共有ソース/最終ボックスを使用し、代替クロスフェードを削除します
偽の3Dz/カメラ移動、オクルージョン、角度付き証明を追加します
間違った最終最終ホールドを追加し、最終マイナスホールドと正確な最終をスナップショットします
シーク不可能なランタイム自動再生を一時停止し、インスタンスを登録し、タイマーを削除し、同期的に構築します
読み取れないテキストラインボックスを維持し、変位を減らし、最終ホールドを追加し、テキストフレームをスナップショットします

完了

hyperframes lint、hyperframes check、hyperframes keyframes、1つのフォーカスされた --shot、およびスナップショットを実行します。最初のフレーム、証明ポーズ、最終マイナスホールド、正確な最終、被写イドメインのモーション、およびデバッグオーバーレイがないことを確認します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: 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`.\n

AlessandroFare/fluxychat

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.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. 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).

AlessandroFare/fluxychat

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.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

関連スキル