Communitygithub.com

9018/mychat

HyperFrames 動畫全知識:原子動作規則、多階段場景藍圖、場景轉場、廣泛的動態設計技巧,以及七種執行時期轉接器。適合任何動畫任務。

mychat 是什麼?

此技能「HyperFrames 動畫」整合了 HyperFrames 框架中所有與動畫相關的知識,提供一套完整、確定性且可組合的動畫創作系統。技能核心包含五大領域:**原子規則**(可組合的動作配方)、**藍圖**(預先設計的多階段場景範本)、**轉場**(場景間切換)、**技巧**(廣泛動態設計模式)以及**轉接器**(針對七大執行時期的 API 文件),支援 GSAP(預設)、Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API 與 TypeGPU/WebGPU。開發者可以透過索引文件快速選取 2-4 條規則組合成自訂動畫,或載入完整藍圖來加速複雜編舞,並透過路由表查詢特定執行時期的 API 細節。此技能極度強調確定性與可尋跡性,遵循 `hyperframes-core` 的約束(如單一暫停時間軸、不可使用隨機數或 `setTimeout`),並提供 `animation-map.mjs` 腳本來分析編舞品質。它適用於 Claude Code、Cursor 及 Codex 等平台,讓 AI 代理能精準產生動畫程式碼。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 動畫

將所有動作知識匯集於一個技能中:規則(原子配方)、藍圖(多階段場景範本)、轉場(場景間切換)、技巧(廣泛的動態設計模式)以及轉接器(各執行時期的 API)。

關於組合合約(data 屬性、子組合、確定性)請參閱 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
命名字體動畫效果(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 內建構時間軸)。此處不再贅述。

在核心合約之上新增的動畫製作注意事項:

  • 預先計算的佈局常數 — 永遠不要在補間時間從 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 — 組合結構、data 屬性、子組合、確定性渲染合約
  • 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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

相關技能