Communitygithub.com

HyperFrames 애니메이션

HyperFrames의 모든 애니메이션 지식 — 원자적 모션 규칙, 다중 페이즈 씬 청사진, 씬 전환, 광범위한 모션 디자인 기법, 그리고 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU)를 포함합니다. 모든 모션 또는 애니메이션 작업에 사용하세요: 2-4개의 규칙을 선택하여 구성하거나, 청사진을 로드하거나, 런타임별 API(예: GSAP 이징/Lottie 플레이어/Three.js 믹서)를 조회할 수 있습니다. 또한 기존 구성의 안무(애니메이션 맵) 감사와 24개의 명명된 텍스트 애니메이션 효과를 다룹니다. HyperFrames 네이티브: 단일 일시 정지 타임라인, 시크(seek) 안전, 결정적.

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

이 스킬은 HyperFrames 프레임워크 내에서 모든 애니메이션 관련 작업을 위한 포괄적인 지식 기반입니다. 개발자나 AI 에이전트가 모션 디자인을 효율적으로 구현할 수 있도록 원자적 모션 규칙, 다중 페이즈 씬 청사진, 씬 전환, 그리고 7가지 런타임 어댑터(GSAP, Lottie, Three.js, Anime.js, CSS, Web Animations API, TypeGPU)에 대한 상세한 문서를 제공합니다. 'rules-index.md'에서 규칙을 선택하거나, 'blueprints-index.md'에서 청사진을 로드하는 방식으로 사용하며, 각 런타임별 어댑터 문서는 구체적인 API 사용법을 안내합니다. 특히 GSAP이 기본 런타임으로 95%의 모션 작업을 담당하며, Lottie는 사전 제작된 타임라인 에셋, Three.js는 3D 씬에 사용됩니다. 또한 'hyperframes-core'의 결정적 렌더링 계약을 준수하며, 애니메이션 맵 스크립트를 통해 구성의 안무를 감사할 수 있습니다. 여러 런타임이 하나의 구성에서 공존할 수 있으며, 각 런타임별로 전역 인스턴스를 등록하여 HyperFrames가 한 번의 패스로 모든 타임라인을 시크(seek)할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/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 시크)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, 컴퓨트 파이프라인)adapters/typegpu.md
HTML-as-texture + 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는 간단한 반복 모티프, 장식, 샤이머(Shimmer)에 사용합니다 — 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 내 타임라인 구성 금지). GSAP autoAlpha 및 명시적 타임라인 경계에서의 0-지속 시간 가시성 설정은 코어에서 허용됩니다. 이러한 예외는 클립 내의 비클립 요소 또는 래퍼에만 사용하세요; 프레임워크가 .clip 라이프사이클을 소유합니다. 전체 계약을 여기에 다시 기술하지 마세요.

코어 계약에 추가되는 애니메이션 제작 규칙:

  • 사전 계산된 레이아웃 상수 — 트윈 시간에 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을 출력합니다. 제작 후 안무(데드 존, 스태거 일관성, 라이프사이클 경고)를 감사하는 데 사용하세요.

animation-map.mjs는 먼저 현재 프로젝트에서 헬퍼 패키지를 확인한 다음, 번들된 HyperFrames 패키지 버전을 부트스트랩할 수 있습니다. 번들 CLI/스킬 설치 외부에서 스킬을 실행하고 부트스트랩 버전을 명시적으로 고정해야 하는 경우에만 HYPERFRAMES_SKILL_PKG_VERSION=<version>을 설정하세요.

참고 자료

  • hyperframes-core — 구성 구조, 데이터 속성, 하위 구성, 결정적 렌더링 계약
  • hyperframes-creative — 팔레트, 타이포그래피, 나레이션, 비트 계획 (애니메이션 외 창의적 방향)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

dbillion/hermes-skills-public

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

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

관련 스킬