Communitygithub.com

AlessandroFare/fluxychat

所有 HyperFrames 的動畫知識 — 包含原子運動規則、多階段場景藍圖、場景轉場、廣泛的動態設計技巧,以及七種執行時期適配器(預設 GSAP,外加 Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。適用於任何動畫任務:挑選 2-4 條規則並組合,或載入藍圖,或查詢特定執行時期 API(例如 GSAP 緩動 / Lottie 播放器 / Three.js 動畫混合器)。也涵蓋審查現有編排的動畫地圖,以及 24 種文字動畫效果。HyperFrames 原生:單一暫停時間軸、可尋址、確定性。

fluxychat 是什麼?

這個技能將所有 HyperFrames 的動畫知識濃縮在一個整合式知識庫中,涵蓋原子運動規則、多階段場景藍圖、場景轉場、廣泛的動態設計技巧,以及七種執行時期適配器(GSAP、Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。開發者可以快速組合 2-4 條規則來建立自訂動畫,或載入預先設計好的藍圖來節省複雜編排的實作時間。它還提供詳細的執行時期路由指南,幫助使用者根據需求選擇最合適的動畫引擎,例如 GSAP 用於 95% 的日常動畫工作,Lottie 用於 After Effects 匯出,Three.js 用於 3D 場景。此外,這個技能強調與 HyperFrames 核心約束保持一致:單一暫停時間軸、確定性、不允許執行時期 DOM 測量,以及僅使用 GSAP 變形別名(x、y、scale、rotation)進行空間運動。它還包含一個動畫地圖腳本,用於在創作後審查編排品質。支援的平台包括任何使用 HyperFrames 或獨立使用 GSAP、Lottie、Three.js、Anime.js、CSS、WAAPI、TypeGPU 的環境,特別適用於複雜的網頁動畫和互動媒體專案。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/hyperframes-animation

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HyperFrames 動畫

所有動畫知識集中在一個技能中:規則(原子配方)、藍圖(多階段場景模板)、轉場(場景到場景)、技巧(更廣泛的動態設計模式),以及適配器(每個執行時期的 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 驅動,在兩個片段之間)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 渲染的畫布(粒子、液體玻璃、自訂著色器)。

多個執行時期可以在一個組合中並存。每個執行時期將其實例註冊到特定於執行時期的全域物件上,以便 HyperFrames 可以在一次傳遞中尋址所有這些實例。

關鍵限制

前提條件: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 套件版本。僅當在捆綁的 CLI / 技能安裝之外執行該技能,並且需要明確釘住該引導版本時,才設定 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

另請參閱

  • hyperframes-core — 組合結構、資料屬性、子組合、確定性渲染契約
  • hyperframes-creative — 色板、排版、敘事、節奏規劃(非動畫的創意方向)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

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

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

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, 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.

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.

相關技能