Communitygithub.com

HyperFrames 애니메이션

HyperFrames를 위한 모든 모션 지식 — 원자적 모션 규칙, 다단계 장면 청사진, 장면 전환, 폭넓은 모션 디자인 기법, 그리고 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU). 모든 모션 또는 애니메이션 작업에 사용하세요.

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

이 스킬은 HyperFrames 프레임워크를 위한 포괄적인 모션 및 애니메이션 규칙 모음입니다. 개발자나 AI 에이전트가 원자적 모션 조리법(규칙), 다단계 장면 템플릿(청사진), 장면 간 전환(트랜지션), 광범위한 모션 디자인 패턴(기법), 그리고 7가지 런타임별 API(GSAP, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU/WebGPU)에 대한 전체 문서를 제공합니다. 주된 사용 방법은 2~4개의 규칙을 선택하여 하나의 일시 정지된 GSAP 타임라인으로 구성하거나, 미리 설계된 다단계 청사진을 로드하여 복잡한 장면을 오케스트레이션하는 것입니다. 모든 애니메이션은 결정론적으로 실행되며, 단일 일시 정지 타임라인을 사용하고, seek이 안전하며, 임의성(무작위 함수)이나 무한 반복을 허용하지 않습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 도구와 통합되어 자연어 지시를 구조화된 HyperFrames 호환 애니메이션 코드로 변환합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/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 (라이브 DOM 캡처 via drawElementImage)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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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.

관련 스킬