Communitygithub.com

AlessandroFare/fluxychat

當 HyperFrames 構圖需要安全尋址的 2D/3D 關鍵幀、GSAP 時間軸、CSS 關鍵幀、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG 變形/繪製、文字軌跡、3D 深度或 `hyperframes keyframes` 診斷時使用。請勿用於廣泛場景策略、品牌設計、媒體來源、字幕或一般影片規劃。

fluxychat 是什麼?

此技能定義了 HyperFrames 環境中動畫關鍵幀的嚴格合約。它強制要求將關鍵幀視為「姿勢合約」-這些合約指定了可見狀態、連續主體身份、可安全尋址的執行環境以及經過驗證的像素。此技能指導開發人員識別動畫主體、選擇最簡單的機制來證明其概念(如 FLIP、路徑移動、筆畫繪製或形狀插值),並遵循特定執行時間規則(例如 GSAP、CSS 關鍵幀、Anime.js、WAAPI)。它支援多種平台與工具,包括 CLI 驗證命令(`hyperframes lint`、`hyperframes check`、`hyperframes keyframes`)、快照、以及用於診斷的鬼影(ghost)模式。其核心價值在於確保動畫可安全尋址(在時間軸上可前後移動)、避免使用 `Date.now()` 或未註冊的 `requestAnimationFrame` 等無法尋址的機制,並透過嚴格的像素驗證(如快照與序列選擇器測試)保證可靠的輸出。此技能也提供了詳細的錯誤修復指南,針對末端點、主體斷裂、偽 3D、無法尋址的執行環境或無法閱讀的文字等常見失敗情況提供明確的解決方案。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 關鍵幀

關鍵幀是一種姿勢合約:可見狀態、連續主體身份、可安全尋址的執行環境、經過驗證的像素。

對於廣泛場景配方,請使用 hyperframes-animation。

對於完整命令文件,請使用 hyperframes-cli。

僅在選擇實作機制而非視覺風格時,才使用 references/keyframe-patterns.md。

流程

  1. 識別動畫主體、可見狀態、最終狀態與執行時間。
  2. 選擇能證明提示的最小機制。僅在機制不明確時才閱讀 references/keyframe-patterns.md。
  3. 在宣告的執行時間中,編寫可安全尋址的關鍵幀。同步建置並註冊執行時間實例。
  4. 使用 hyperframes lint、hyperframes check、hyperframes keyframes、一個聚焦的 --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。

關鍵幀形式

  • 陣列關鍵幀:帶有逐步驟持續時間/緩動的姿勢階梯。
  • 百分比關鍵幀:單個補間內的精確時間。
  • 屬性陣列:緊湊的多站點變更。
  • 當每個站點自帶緩動時,父級使用 ease: "none"。
  • 當每個片段應共享相同感覺時使用 easeEach。

請勿從範例中複製數值距離或時間。根據實際構圖的幾何形狀與持續時間推導它們。

對於在兩個盒子之間移動的單一主體,偏好一個連續的變換補間或 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 軸移動、旋轉、攝影機/世界運動、遮擋以及物件交叉時的圖層順序。

使用一個或兩個能揭露深度關係的診斷角度。若角度證明未顯示深度交叉,請改進 z/攝影機/遮擋。

Canvas / 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就地運動、重疊、接觸、微妙的縮放/不透明度、文字波浪
--ghostCanvas、WebGL、著色器運動、渲染的 3D
snapshot --at遮罩、文字可讀性、完整狀態、最終鎖定、黑色/重置尾端

若選擇器證明看起來有誤:

  1. 重新執行 --json
  2. 找到實際的動畫目標
  3. 拍攝該目標
  4. 快照完整影格
  5. 信任已繪製的像素而非日誌

診斷解讀

flat 表示沒有明確的中間姿勢。keyframes 表示存在明確的停止點。motionPath 表示存在路線。trace 表示多筆畫繪製。composed with 表示子級運動繼承了父級運動。

均勻的鬼影間距表示恆定速度。聚集的鬼影表示慢入或穩定。大間距表示快速移動。

輔助選擇器拍攝並非證明。在破碎的完整影格上進行洋蔥皮拍攝並非證明。

錯誤處理

失敗修復
僅有端點添加中間姿勢、保持峰值證明、重新執行 --shot
身份斷裂保持一個元素存活、使用共享來源/最終盒子、移除替代交叉淡變
偽 3D添加 z/攝影機移動、遮擋、角度證明
錯誤的最終狀態添加最終保持、快照最終保持前與精確最終狀態
無法尋址的執行環境暫停自動播放、註冊實例、移除計時器、同步建構
無法閱讀的文字保留行盒子、減少位移、添加最終保持、快照文字影格

完成

執行 hyperframes lint、hyperframes check、hyperframes keyframes、一個聚焦的 --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.

相關技能