Communitygithub.com

dbillion/hermes-skills-public

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

hermes-skills-public 是什麼?

這個技能是 HyperFrames 動畫框架的完整知識庫,專為在 HyperFrames 環境中處理任何動作或動畫任務而設計。它將所有動畫知識整合到一個技能中,包含五個核心概念:原子運動規則(atomic recipes)、多階段場景藍圖(multi-phase scene templates)、場景轉場(scene-to-scene transitions)、更廣泛的動態設計技術(broader motion-design patterns),以及七個執行時期適配器(runtime adapters)。使用者可以透過組合 2-4 條原子規則來快速建立動畫,或在需要更複雜的場景級協調時載入預先設計的藍圖。技能也提供執行時期路由表,協助開發者根據需求選擇合適的適配器,例如 GSAP 適用於 95% 的動畫工作、Lottie 用於 After Effects 導出資產、Three.js 用於 3D 場景、Anime.js 用於輕量級補間、CSS 用於簡單重複圖案、WAAPI 用於原生瀏覽器關鍵影格、TypeGPU 用於 GPU 渲染畫布。此外,技能還提供一個動畫地圖腳本(animation-map.mjs)用於審核構圖的編舞品質,並強調遵循核心合約(hyperframes-core)的非協商規則,例如單一暫停時間軸、確定性渲染、禁止執行時期 DOM 測量等。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/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 6 individual skills — each has its own dedicated page.

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

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.

dbillion/hermes-skills-public

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.

dbillion/hermes-skills-public

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

相關技能