Communitygithub.com

HyperFrames 애니메이션

모든 모션 지식을 하나의 스킬로 제공합니다: 원자적 규칙, 다중 단계 씬 템플릿, 씬 전환, 모션 디자인 패턴, 그리고 7가지 런타임 어댑터(GSAP 기본 포함).

HyperFrames 애니메이션란 무엇인가요?

이 스킬은 HyperFrames 프레임워크에서 모든 모션 및 애니메이션 작업을 수행하기 위한 포괄적인 지식 베이스입니다. **규칙**(원자적 레시피), **블루프린트**(다중 단계 씬 템플릿), **전환**(씬 간), **기법**(광범위한 모션 디자인 패턴), **어댑터**(런타임별 API) 등 다섯 가지 주요 영역을 다룹니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있습니다. 이 스킬의 핵심은 단일 일시 중지 타임라인에서 확정적(deterministic)으로 실행되는 HyperFrames의 렌더링 계약을 따릅니다. 사용자는 2-4개의 규칙을 조합하거나, 블루프린트를 로드하거나, 특정 런타임(GSAP, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU)의 API를 조회하여 작업을 수행할 수 있습니다. 비동기 코드, 랜덤 값, 무한 반복을 금지하는 등의 중요한 제약 조건을 따르며, 성능과 결정론적 출력을 보장합니다.

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

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

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

문서

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 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 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-nextjs

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-nextjs

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

관련 스킬