Communitygithub.com

Army161/OpenMontage

HyperFrames 的所有動畫知識 — 原子運動規則、多階段場景藍圖、場景轉場、更廣義的動態設計技巧,以及七個執行時期轉接器(GSAP 預設,加上 Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。適用於任何動畫任務:挑選 2-4 條規則組合,或載入藍圖,或查閱特定執行時期的 API(例如 GSAP 的 easing / Lottie 播放器 / Three.js 動畫混合器)。HyperFrames 原生:單一暫停的時間軸,安全搜尋,確定性。

OpenMontage 是什麼?

此技能「Army161/OpenMontage」是為 HyperFrames 生態系統設計的全面動畫知識庫,專注於提供從原子運動規則到完整場景藍圖,以及多種執行時期轉接器的動畫組合能力。它的核心價值在於讓開發者或 AI 代理能透過選取 2-4 條原子規則快速組合出動畫,或直接載入預先設計好的多階段場景藍圖(如品牌揭露、社交證明等),大幅節省作者時間。技能支援七種執行時期轉接器,包括預設的 GSAP(負責 95% 的動畫工作,涵蓋時間軸編排、變形、easing 與 stagger)、Lottie(用於 After Effects 匯出素材)、Three.js(3D 場景與攝影機動畫)、Anime.js(輕量補間)、CSS 關鍵影格(簡單重複圖案)、Web Animations API(無需 GSAP 依賴的原生瀏覽器動畫),以及 TypeGPU/WebGPU(GPU 渲染畫布)。其運作遵循 HyperFrames 核心的嚴格規範,例如單一暫停時間軸、由 data-duration 控制長度、禁止隨機性與非同步時間軸建構,確保動畫的確定性與可重複性。此技能適用於 Claude Code、Cursor 等支援 HyperFrames 的 AI 代理工具,適合任何需要動畫組合、查閱 API 或審計編排的開發任務。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.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 — easing / staggeradapters/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% 動畫工作的預設 — 涵蓋時間軸編排、變形、easing、stagger。此技能中的所有原子規則都基於 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。用於在編寫後審計編排(死區、stagger 一致性、生命週期警告)。

參見

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

Army161/OpenMontage

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). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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.

Army161/OpenMontage

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.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

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.

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

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

相關技能