Communitygithub.com

Aseel1600/Edit01

HyperFrames 動畫所有知識 — 原子運動規則、多階段場景藍圖、場景轉場、更廣泛的動態設計技巧,以及七種運行時適配器(預設 GSAP,加上 Lottie、Three.js、Anime.js、CSS 關鍵幀、Web 動畫 API、TypeGPU)。用於任何運動或動畫任務:選取 2-4 條規則並組合,或載入藍圖,或查詢特定運行時 API(例如 GSAP 緩動 / Lottie 播放器 / Three.js 混合器)。HyperFrames 原生:單一暫停時間軸、可尋址、確定性。

Edit01 是什麼?

此技能將 HyperFrames 生態系統中所有與動畫相關的知識整合到一個可查詢的索引中。它涵蓋五個層面:原子運動規則(可組合的 GSAP 配方)、多階段場景藍圖(預先設計的編排模板)、場景到場景的轉場、更廣泛的動態設計技巧,以及針對七種運行時的特定 API 參考(GSAP、Lottie、Three.js、Anime.js、CSS 動畫、Web 動畫 API 和 TypeGPU/WebGPU)。主要用例是透過組合 2-4 條規則來快速建立動畫,這比從頭開始編寫或載入完整藍圖更快。對於複雜場景,藍圖提供了可立即執行的範例程式碼。該技能強制執行 HyperFrames 核心合約:所有動畫都必須使用單一暫停的時間軸、依賴 `data-duration` 屬性,並避免非確定性操作(如 `Math.random` 或 `setTimeout`)。它在 Claude Code、Cursor 和 Cursor Composer 上運作最佳,支援 Markdown 輸出。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/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 動畫 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 內建構時間軸)。此處不重述。

在核心合約基礎上的動畫創作補充:

  • 預計算佈局常數 — 切勿在補間時從 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 20 individual skills — each has its own dedicated page.

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

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.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Aseel1600/Edit01

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

Aseel1600/Edit01

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Aseel1600/Edit01

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

相關技能