Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames 애니메이션에 대한 모든 지식 — 원자적 모션 규칙, 다중 단계 장면 청사진, 장면 전환, 광범위한 모션 디자인 기법 및 7개의 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU). 모든 모션 또는 애니메이션 작업에 사용: 2-4개 규칙을 선택하여 구성하거나 청사진 로드, 런타임별 API(예: GSAP 이징/Lottie 플레이어/Three.js 믹서) 조회. 또한 기존 구성의 안무(애니메이션 맵) 감사 및 24개의 명명된 텍스트 애니메이션 효과 지원. HyperFrames 네이티브: 단일 일시 정지 타임라인, 탐색 가능, 결정적.

hyperframes-instruct란 무엇인가요?

이 스킬은 HyperFrames 프레임워크 내에서 모션 및 애니메이션 작업을 위한 포괄적인 지식 기반을 제공합니다. 이 스킬은 원자적 모션 규칙(rules-index.md), 다중 단계 장면 청사진(blueprints-index.md), 장면 전환, 모션 디자인 기법, 그리고 7개의 런타임 어댑터(GSAP, Lottie, Three.js, Anime.js, CSS, WAAPI, TypeGPU)에 대한 상세 문서를 포함합니다. 개발자는 이 스킬을 사용하여 2-4개의 원자적 규칙을 빠르게 조합하여 단순한 모션을 생성하거나, 복잡한 4-5단계 안무를 위해 사전 설계된 청사진을 로드할 수 있습니다. 또한 'animation-map.mjs' 스크립트를 사용하여 기존 구성의 애니메이션 맵을 감사하고 24개의 명명된 텍스트 애니메이션 효과에 액세스할 수 있습니다. 핵심 제약 조건으로는 단일 일시 정지 타임라인, 결정적 렌더링(무작위성 금지), 사전 계산된 레이아웃 상수 사용(getBoundingClientRect() 금지), GSAP 트랜스폼 별칭(x, y, scale, rotation)만 사용하는 공간 모션 등이 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트가 HyperFrames 기반 프로젝트에서 정확하고 효율적인 애니메이션 코드를 생성하고 감사할 수 있도록 지원합니다.

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

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

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

문서

플러그인 설치: 설정 또는 최신 상태 확인 명령 전에 이 스킬이 HyperFrames 플러그인 내에 있는 경우 플러그인 실행 규칙을 따릅니다. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.

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
모션 블러 — 요소의 셔터 스미어, 사용하지 말아야 할 경우references/motion-blur.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
캐릭터 애니메이션 (걷기 사이클, 마스코트, 관절 인형, 제스처)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는 간단한 반복 모티프, 장식, 샤이머에 사용됩니다 — JavaScript 애니메이션 비용 없음.
  • WAAPI는 GSAP 의존성 없이 네이티브 브라우저 키프레임에 사용됩니다.
  • TypeGPU / WebGPU는 GPU 렌더링 캔버스(파티클, 액체 유리, 커스텀 셰이더)에 사용됩니다.

여러 런타임은 하나의 컴포지션에서 공존할 수 있습니다. 각 런타임은 해당 런타임별 전역에 인스턴스를 등록하여 HyperFrames가 한 번에 모두를 탐색할 수 있도록 합니다.

중요한 제약 조건

전제 조건: hyperframes-core → 하나의 일시 정지 타임라인 + 변경 불가 규칙 (단일 일시 정지 타임라인, data-duration이 길이를 제어, Math.random / Date.now / performance.now 사용 금지, 유한한 루트 data-duration 없이 repeat: -1 사용 금지, 이후 장면 클립에 대한 페이지 로드 gsap.set 사용 금지, display 또는 원시 visibility 트윈 금지, 그리고 타임라인이 완전히 빌드된 후에만 등록 — 빌드가 document.fonts.ready와 같은 비동기 콜백 내에서 실행될 때도 동일). 명시적 타임라인 경계에서의 GSAP autoAlpha 및 제로 지속 시간 가시성 설정은 코어에서 허용됩니다. 이러한 예외는 클립 내의 비클립 요소 또는 래퍼에만 사용하십시오. 프레임워크는 .clip 라이프사이클을 소유합니다. 전체 계약을 여기에 반복해서 명시하지 마십시오.

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

  • 사전 계산된 레이아웃 상수 — 트윈 시간에 getBoundingClientRect()에서 위치를 파생시키지 마십시오. 트윈 시간 DOM 측정은 렌더러가 병렬로 샘플링하기 때문에 동기화가 해제됩니다. 컴포지션 설정 시 한 번 좌표를 계산하고 재사용하십시오.
  • 공간 모션은 GSAP 트랜스폼 별칭만 사용 (x, y, scale, rotation). 코어의 허용 목록은 비공간 속성 트윈에 대해 opacity / color / backgroundColor / borderRadius도 허용하지만 — 레이아웃 변경을 위해 width / height / top / left는 절대 사용하지 마십시오.

스크립트

node <SKILL_DIR>/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 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

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, timeline, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

관련 스킬