Communitygithub.com

Army161/OpenMontage

HyperFrames의 모든 애니메이션 지식을 한 곳에 — 원자적 모션 규칙, 다중 페이즈 씬 청사진, 씬 전환, 광범위한 모션 디자인 기법, 그리고 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU). 모션 또는 애니메이션 작업에 사용: 2~4개의 규칙을 선택하여 구성하거나, 청사진을 로드하거나, 런타임별 API를 조회하세요.

OpenMontage란 무엇인가요?

HyperFrames 애니메이션 스킬은 하나의 통합된 지식 베이스로, 원자적 모션 규칙부터 다중 페이즈 씬 청사진, 씬 간 전환, 광범위한 모션 디자인 패턴, 그리고 7가지 애니메이션 런타임(GSAP, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU)에 대한 완전한 어댑터를 제공합니다. 대부분의 작업에 GSAP을 기본 런타임으로 사용하며, 각 규칙은 HTML/CSS/GSAP 레시피 형태로 문서화되어 있습니다. 청사진은 브랜드 리빌, 소셜 프루프 같은 복잡한 4-5페이즈 안무를 위한 사전 설계된 템플릿을 제공합니다. 이 스킬은 단일 일시정지 타임라인, seek 안전성, 결정론적 렌더링 계약 등 HyperFrames 코어의 비협상 규칙을 엄격히 따릅니다. 모든 애니메이션은 `data-duration`으로 길이가 제어되며, `Math.random`, `Date.now`, `Math.random`, `Date.now`, `performance.now` 같은 비결정적 요소나 무한 반복(`repeat: -1`)을 허용하지 않습니다. 각 런타임은 전역 객체에 인스턴스를 등록하여 HyperFrames가 한 번의 seek 패스로 모든 애니메이션을 동기화할 수 있습니다. 또한, 트윈 시간에 DOM 측정을 금지하고, 레이아웃 변경에 `width`/`height`/`top`/`left` 대신 GSAP 변환 별칭(`x`, `y`, `scale`, `rotation`)만 사용하도록 강제합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, `scripts/animation-map.mjs` 스크립트를 통해 애니메이션 맵을 생성하여 안무 감사(audit)를 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HyperFrames 애니메이션

모든 모션 지식을 하나의 스킬로: 규칙(원자적 레시피), 청사진(다중 페이즈 씬 템플릿), 전환(씬 간), 기법(광범위한 모션 디자인 패턴), 어댑터(런타임별 API).

구성 계약(데이터 속성, 하위 구성, 결정론)은 hyperframes-core를 참조하세요.

기본값: 원자적 규칙 구성

rules-index.md에서 2-4개의 규칙을 선택하고, 단일 일시정지된 GSAP 타임라인으로 결합하면 됩니다. 청사진부터 시작하는 것보다 빠르고 코드도 적게 생성됩니다.

청사진 로드가 적합한 경우

  • 씬이 기존에 설계된 다중 페이즈 템플릿(브랜드 리빌, 소셜 프루프 등)과 일치하고, 해당 페이즈 파이프라인을 재사용하면 실제 제작 시간이 절약되는 경우
  • 복잡한 4-5 페이즈 안무에 대한 실행 가능한 ground-truth 코드가 필요한 경우

청사진은 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 seek)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, 컴퓨트 파이프라인)adapters/typegpu.md
HTML-텍스처 + WebGL/GLSL 포스트 FX (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가 한 번의 패스로 모두 seek할 수 있습니다.

중요한 제약 사항

전제 조건: 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.

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.

관련 스킬