Communitygithub.com

Zuhair-01/claude-skills-and-systems

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

claude-skills-and-systems 是什麼?

這個技能將 HyperFrames 動畫系統的所有知識濃縮成一個統一的技能,為 AI 代理(如 Claude Code)提供在 GSAP、Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API 和 TypeGPU 等七種環境下處理任何動畫或動態任務所需的結構化參考。技能的核心在於其分層架構:原子規則(2-4 條即可快速組合出複雜動畫)、多階段場景藍圖(用於重用經過驗證的編排模式)、場景轉場以及更廣泛的動態設計技巧。它強制執行關鍵約束以維持 HyperFrames 的確定性、可尋址行為,例如要求使用單一暫停時間軸、禁止使用 `Math.random` 以及要求使用預先計算的佈局常數。此外,它還包含用於審計構圖的腳本、七個運行時專屬的詳細 API 參考,以及 24 種具名文字動畫效果,使其成為在 HyperFrames 生態系統中建構宣告式、可預測動畫的完整解決方案。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/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
動態模糊 — 元素上的快門模糊效果,以及何時不使用它references/motion-blur.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
角色動畫(行走循環、吉祥物、關節木偶、手勢)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
具名文字動畫效果(24 種 ID,透過外部 animate-text 技能)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 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

相關技能