Communitygithub.com

HyperFrames アニメーション

HyperFrames のためのアニメーション知識一式 — 原子モーションルール、多相シーンブループリント、シーン間トランジション、モーションデザイン技法、そして7つのランタイムアダプター(GSAP デフォルト、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU)。あらゆるモーション/アニメーションタスクに使用可能:ルールを2~4つ選んで構成するか、ブループリントを読み込むか、ランタイム固有の API(例:GSAP イージング、Lottie プレイヤー、Three.js ミキサー)を参照します。

HyperFrames アニメーション とは?

このスキルは、HyperFrames エコシステムにおけるすべてのアニメーション知識を統合したナレッジベースです。原子ルール(レシピ)、ブループリント(多相シーンテンプレート)、トランジション(シーン間)、技法(より広範なモーションデザインパターン)、アダプター(ランタイム固有 API)の5つのカテゴリで構成されています。主な利用方法は、`rules-index.md` から2~4のルールを選び、単一の一時停止 GSAP タイムラインで合成する高速な方法と、複雑な多相シーンには `blueprints-index.md` からテンプレートを読み込む方法です。7つのランタイムアダプター(GSAP、Lottie、Three.js、Anime.js、CSS キーフレーム、Web Animations API、TypeGPU/WebGPU)をサポートし、複数のランタイムを1つのコンポジション内で共存させることも可能です。重要な制約として、`hyperframes-core` が定める単一一時停止タイムライン、`data-duration` による長さ管理、`Math.random` 等の非決定性の排除、レイアウト変更への `width`/`height` 不使用といったルールを順守する必要があります。このスキルは Claude Code、Cursor、Codex などの AI エージェントが HyperFrames プロジェクトでモーション設計やデバッグを行う際に役立ちます。

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

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

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

ドキュメント

HyperFrames アニメーション は何をしますか?

すべてのモーション知識を1つのスキルに集約:ルール(原子レシピ)、ブループリント(多相シーンテンプレート)、トランジション(シーン間)、技法(より広範なモーションデザインパターン)、アダプター(ランタイム固有 API)。

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

デフォルト:原子ルールの合成

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

ブループリントを読み込むタイミング

  • シーンが既存の設計済み多相テンプレート(ブランドリビール、ソーシャルプルーフ、デモページスクロールスポットライトなど)に合致し、そのフェーズパイプラインを再利用することで実際の作成時間を節約できる場合
  • 複雑な4~5フェーズの振り付けに対する実行可能な真実コードが必要な場合

ブループリントは blueprints-index.md にあります。各エントリは blueprints/<id>.md(レシピ)と examples/<id>.html(実行可能サンプル)を指します。推測読み込みはせず、シーンレベルのオーケストレーションが必要だと判断した後に読み込んでください。

ルーティング

目的参照先
トリガー/タグで原子モーションパターンを選ぶrules-index.md
1つのルールの完全な HTML/CSS/GSAP レシピを読むrules/<name>.md
多相シーンテンプレートを選ぶblueprints-index.md
1つのブループリントの完全なレシピを読むblueprints/<id>.md + examples/<id>.html
シーン間トランジション(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 をテクスチャとして+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 内でのタイムライン構築禁止)。ここでは再記述しません。

コアの契約に追加するアニメーション作成上の注意点:

  • 事前計算済みレイアウト定数 — トゥイーン時に 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 を出力します。作成後に振り付け(デッドゾーン、スタガーの一貫性、ライフサイクル警告)を監査するために使用します。

関連項目

  • hyperframes-core — コンポジション構造、データ属性、サブコンポジション、決定性レンダリング契約
  • hyperframes-creative — パレット、タイポグラフィ、ナレーション、ビート計画(アニメーション以外のクリエイティブディレクション)
  • hyperframes-cli — npx hyperframes lint / validate / inspect / preview / render

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

関連スキル