Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames 컴포지션에서 펀치 인/아웃, 줌, 리프레임, 켄 번스 효과, 카메라 움직임, 시각적 매치/휩 핸드오프, 기타 시크-세이프 2D/3D 키프레임을 사용해야 할 때 활용하세요. GSAP, CSS 키프레임, Anime.js, WAAPI, FLIP, 패스, 마스크, SVG 모프/드로우, 텍스트 트레일, 3D 깊이, 또는 `hyperframes keyframes` 진단에도 사용됩니다. 광범위한 장면 전략, 브랜드 디자인, 미디어 소싱, 캡션, 일반 비디오 계획에는 사용하지 마세요.

hyperframes-instruct란 무엇인가요?

HyperFrames Keyframes 스킬은 HyperFrames 컴포지션 내에서 정밀한 시각적 모션을 구현하기 위한 완전한 도구 세트입니다. 펀치 인/아웃, 줌, 켄 번스 효과, 매치 컷 등 다양한 카메라 움직임과 프레이밍 작업을 지원하며, GSAP, CSS 키프레임, Anime.js, WAAPI, FLIP과 같은 여러 메커니즘을 사용하여 시크-세이프한 방식으로 키프레임을 생성합니다. 이 스킬은 단순한 모션을 넘어 패스 트래블, SVG 모프/드로우, 텍스트 애니메이션, 3D 깊이 효과 등 고급 기법을 포괄합니다. CLI 명령어(`hyperframes check`, `hyperframes keyframes`, `hyperframes snapshot`)를 통해 키프레임을 진단하고 검증할 수 있어, 안정적이고 예측 가능한 렌더링을 보장합니다. HyperFrames 프레임워크의 일부로, `hyperframes-core`(타임라인, 클립), `hyperframes-audio`(오디오 페이드, 볼륨), `hyperframes-animation`(시각적 핸드오프) 등의 다른 스킬과 함께 사용됩니다. 주요 특징으로는 객체 정체성 유지, 최종 상태 정의, 시크-세이프 런타임 보장이 있으며, 애니메이션 대상과 포즈(visible state)를 명확히 지정해야 합니다. 각 런타임(GSAP, CSS, Anime.js, WAAPI)에 대한 구체적인 규칙과 금지사항(`Date.now()`, 무한 루프 등)을 제공하며, 렌더링 전 검증 워크플로우를 강조합니다.

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

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

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

문서

플러그인 설치: 설정 또는 freshness 명령 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.

HyperFrames Keyframes

키프레임은 포즈 계약입니다: 보이는 상태, 연속적인 주체 정체성, 시크-세이프 런타임, 검증된 픽셀.

광범위한 장면 레시피는 hyperframes-animation을 사용하세요. 전체 명령 문서는 hyperframes-cli를 사용하세요. references/keyframe-patterns.md는 시각적 스타일이 아닌 구현 메커니즘을 선택할 때만 참조하세요.

크리에이터 편집 경계

키프레임은 클립 조립이 아닌 시각적 모션을 담당합니다. 소스 범위 하드 컷, 트림, 스플라이스, 재정렬은 /hyperframes-core에 속합니다: 유지된 범위당 하나의 미디어 요소를 작성하고, data-start와 data-duration으로 배치하며, data-media-start로 소스 오프셋을 선택합니다. 인접한 범위는 하드 컷을 만듭니다. 크로스페이드는 다른 트랙에서 겹치는 클립과 시각적 불투명도 키프레임을 사용합니다; 사운드 페이드는 /hyperframes-audio를 사용합니다.

크리에이터 요청진실된 메커니즘
펀치 인 / 펀치 아웃클립 내부의 비시간 기반 시각적/크롭 래퍼에 scale과 x/y 또는 백분율 변환을 키프레임으로 적용합니다. 하드 펀치는 설정/짧은 트윈을, 부드러운 이동은 트윈을 사용합니다.
부드러운 다중 상태 줌 또는 리프레임하나의 주체 래퍼를 유지하고 여러 줌/리프레임 상태를 세그먼트별 이징이 있는 포즈 사다리로 작성합니다.
팬, 리프레임 또는 켄 번스 카메라 움직임래퍼 변환과 스케일을 애니메이션합니다. 지오메트리가 작성됩니다; 이것은 얼굴 추적이나 자동 의미론적 리프레이밍이 아닙니다.
연쇄 카메라 움직임하나의 등록된 시크-세이프 타임라인에 레이블이 지정된 변환 비트를 연결합니다.
매치 컷 또는 휩 팬/hyperframes-animation이 시각적 핸드오프를 담당합니다; /hyperframes-registry가 프리미티브를 제공합니다; 키프레임은 작성된 지오메트리, 방향, 속도를 유지합니다. 자동 매칭 프레임 발견은 없습니다.
크롭 및 마스크 리프레임내부 시각적 래퍼에 clip-path 또는 마스크를 보간하여 소스 시간 변경 없이 크롭/리프레임합니다. 폴리곤 키프레임은 폴리곤/마스크 전환을 형성할 수 있습니다.
방향성 와이프 컷 또는 아이리스/리빌 컷겹치는 시각적 클립에 걸쳐 마스크/클립 경계를 애니메이션합니다; /hyperframes-animation이 핸드오프 choreography를 담당합니다.
분할 화면 핸드오프코어에 의해 배치된 두 시각적 클립을 유지한 다음, 내부 크롭/마스크 래퍼와 디바이더 지오메트리를 키프레임합니다.
일정한 소스 리타임/hyperframes-core는 렌더-세이프 픽처와 피치 보존 사운드를 위해 정규화된 data-playback-rate (0.1..10)을 담당합니다. 전체 미디어 요소에 대해 일정합니다.
소스 속도 램프<video>/<audio>의 data-automation에 rate 레인(클립 초 단위 t, 0.1..10 범위 v, 로그 보간); 일정한 속도보다 우선합니다.
프리즈 / 홀드시각적 포즈, 최종 소스 프레임 또는 완료된 하위 컴포지션을 유지할 수 있습니다. 임의의 중간 소스 프리즈는 지원되지 않습니다; 정지/파생된 세그먼트를 전처리하여 자체 클립으로 배치한 다음 다른 소스 범위로 재개합니다.

픽처와 사운드를 함께 편집할 때는 /hyperframes-core, 시각적 모션을 위한 이 스킬, 배치된 트랙의 페이드, 크로스페이드, 볼륨 오토메이션, 덕킹/카브, 또는 효과를 위한 /hyperframes-audio를 로드하세요.

시각적 전환 또는 크롭 처리는 시간적 소스 트림 또는 스플라이스가 아닙니다. /hyperframes-core는 타임라인, 클립 타이밍, 소스 범위를 담당합니다; 키프레임은 해당 클립 내부의 래퍼에서 보이는 핸드오프 또는 크롭만 애니메이션합니다. 복사 가능한 결합 픽처/사운드 레시피는 /hyperframes-core → references/creator-editing-recipes.md를 사용하세요.

절차

  1. 애니메이션 대상, 보이는 상태, 최종 상태, 런타임을 식별합니다.
  2. 프롬프트를 증명하는 가장 작은 메커니즘을 선택합니다. 메커니즘이 명확하지 않은 경우에만 references/keyframe-patterns.md를 읽습니다.
  3. 선언된 런타임에서 시크-세이프 키프레임을 작성합니다. 빌드가 완료된 후에만 런타임 인스턴스를 등록합니다; document.fonts.ready 내부에서 빌드하는 것은 괜찮습니다.
  4. hyperframes check (린트 실행), hyperframes keyframes, 하나의 집중된 --shot, 증명 시점의 스냅샷으로 확인합니다.
  5. 증명이 실패하면 소스 키프레임을 수정하고 렌더링 전에 가장 작은 실패 진단을 다시 실행합니다.

계약

  • 움직이는 대상을 명명합니다.
  • 최종 상태를 포함하여 의도된 모션을 증명하는 데 필요한 포즈를 명명합니다.
  • 보이는 채널을 키프레임합니다. 숨겨진 헬퍼 상태는 키프레임하지 않습니다.
  • 연속성이 중요할 때 객체 정체성을 유지합니다.
  • 의도된 모션이 대체 또는 용해일 때만 크로스페이드합니다.
  • 읽을 수 있거나 의미론적인 상태를 볼 수 있을 만큼 충분히 오래 유지합니다.
  • 최종 프레임은 애니메이션의 일부입니다. 정리가 아닙니다.
  • 요청되지 않은 한 휴식 상태로 재설정하지 마십시오.
  • 요청되지 않은 한 검은색으로 끝나지 마십시오.
  • 스타터 장면을 편집하는 경우, 재설계를 요청하지 않는 한 레이아웃, 사본, 에셋, 색상, 최종 상태를 유지합니다.

런타임 규칙

GSAP:

  • 페이지 로드 시 또는 document.fonts.ready 내부에서 빌드하고, 빌드가 완료된 후에만 등록합니다.
  • gsap.timeline({ paused: true })를 사용합니다.
  • window.__timelines[compositionId]로 등록합니다.
  • 레지스트리 키는 data-composition-id와 일치해야 합니다.
  • 렌더 크리티컬 모션을 위해 tl.play()를 호출하지 마십시오.
  • 반복을 유한하게 유지합니다.

CSS 키프레임:

  • 유한한 지속 시간과 반복 횟수.
  • 결정론적 지연.
  • animation-fill-mode: both
  • 타이밍이 클립에 속할 때 data-start를 사용합니다.

Anime.js:

  • 동기적으로 생성합니다.
  • autoplay: false
  • 유한한 지속 시간과 루프.
  • 모든 인스턴스를 window.__hfAnime에 푸시합니다.

WAAPI:

  • 유한한 duration
  • fill: "both"
  • 결정론적 구성.
  • 텍스트 표면에는 WAAPI가 나열되지 않습니다; --shot (WAAPI를 탐색) 및 스냅샷으로 확인합니다.

렌더 크리티컬 모션에 절대 사용하지 마십시오:

  • Date.now()
  • performance.now()
  • 시드되지 않은 Math.random()
  • 호버/스크롤 트리거
  • 타이머
  • 비동기 빌드가 완료되기 전에 등록된 타임라인
  • 등록되지 않은 requestAnimationFrame
  • 무한 루프

GSAP 스켈레톤

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

의미론적 상태에는 레이블을 사용하세요. 연결된 지연 대신 위치 매개변수를 사용하세요. 동일한 속성을 건드리는 나중의 from()/fromTo() 트윈에는 immediateRender: false를 사용하세요.

키프레임 형식

  • 배열 키프레임: 단계별 지속 시간/이징이 있는 포즈 사다리.
  • 백분율 키프레임: 하나의 트윈 내 정확한 타이밍.
  • 속성 배열: 간결한 다중 중지 변경.
  • 각 중지가 자체 이징을 가질 때 부모에 ease: "none".
  • 모든 세그먼트가 동일한 느낌을 공유해야 할 때 easeEach.

예제에서 숫자 거리나 타이밍을 복사하지 마십시오. 실제 컴포지션 지오메트리와 지속 시간에서 파생하십시오.

두 상자 사이를 이동하는 하나의 주체의 경우, 하나의 연속적인 변환 트윈 또는 FLIP을 선호합니다. 뷰어가 별개의 비트를 느껴야 할 때만 x/y/scale을 여러 개의 이징된 키프레임으로 분할하십시오; 모든 세그먼트는 속도를 변경하며 걸림으로 읽힐 수 있습니다.

채널

컴포지터/시각적 채널을 선호합니다: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, 마스크, CSS 변수, SVG 경로/대시 값, 카메라 변환, 셰이더 유니폼.

레이아웃/라이프사이클 채널을 피하십시오: top/left/right/bottom, width/height, margin/padding, display, visibility, 늦은 DOM 생성, 주체 모션을 수행하는 헬퍼 오버레이.

가시성 변경에는 등록된 탐색 가능 GSAP 타임라인의 autoAlpha 또는 명시적 경계에서의 지속 시간이 0인 tl.set()을 사용하십시오. 클립이 아닌 요소 또는 클립 내부의 래퍼만 대상으로 지정하십시오; 절대 .clip 자체를 대상으로 지정하지 마십시오. 절대 원시 visibility를 지속 시간 트윈하지 말고 display를 트윈하지 마십시오.

메커니즘 선택

프롬프트를 증명하는 가장 작은 메커니즘을 선택하십시오:

필요메커니즘
동일한 주체가 상자 또는 계층 구조를 변경공유 요소 / FLIP
주체가 보이는 경로를 따라 이동경로 트래블
획이 성장하거나 추적획 드로우
한 모양이 다른 모양이 됨모양 보간
리빌 경계가 보임클립, 마스크 또는 셰이더 유니폼
여러 항목이 순서대로 이동스태거 / 인덱스 지연
텍스트 자체가 이동라인, 단어, 문자 또는 밴드 세분화
표면이 구부러지거나, 늘어나거나, 크롭부모/자식 카운터 변환
UI에 상태가 있음명시적 상태 머신
장면에 깊이가 있음DOM 3D, Three.js 또는 WebGL 카메라/객체 키프레임

메커니즘은 결합될 수 있지만, 각각은 아이디어를 명확히 해야 합니다. 장식은 증명이 아닙니다.

타이밍

  • 원인이나 방향을 명확히 할 때만 예측.
  • 가속은 휴식 상태에서 출발.
  • 피크 증명은 메커니즘을 틀림없이 보여줌.
  • 후속 동작은 에너지와 방향을 전달.
  • 주체가 탄력적이거나 촉각적이어야 할 때만 오버슈트.
  • 일정한 속도의 경로 트래블은 일반적으로 ease: "none"이 필요.
  • 이산적인 UI 상태는 일반적으로 날카로운 ease-out이 필요.
  • 반복되는 요소는 동일한 타이밍이 아닌 정렬된 오프셋이 필요.
  • 최종 잠금은 전환 포즈보다 더 긴 홀드가 필요.
  • 부드러움은 동일한 주체에서 연속적인 속도를 의미.
  • 동일한 변환 속성을 쓰는 트윈을 겹치지 마십시오. 의도적이고 검증된 경우는 제외.
  • 주요 영웅 표면이 동시에 스케일링되거나 이동하는 동안 큰 clip-path/마스크 변경을 애니메이션하지 마십시오; 주요 이동이 안정된 후에 중첩된 리빌을 사용하십시오.

텍스트

라인 상자, 단어 간격, 가독성, 최종 맞춤을 유지하십시오. 텍스트가 내부적으로 이동하면 텍스트 주변의 장식뿐만 아니라 글리프 또는 마스킹된 밴드를 이동하십시오. 읽을 수 있는 프레임을 스냅샷하십시오.

SVG

획 성장에는 DrawSVGPlugin을 선호하고, 그 다음 stroke-dasharray/stroke-dashoffset을 선호합니다. 모양 보간에는 MorphSVGPlugin을 선호하고; 필요할 때 프리미티브를 경로로 변환하고 복잡한 실루엣을 더 간단한 부분으로 분할하십시오.

3D

스케일만으로는 가짜 깊이입니다. 안정적인 부모에 원근, transform-style: preserve-3d, z 이동, 회전, 카메라/월드 모션, 폐색, 객체가 교차할 때 레이어 순서를 사용하십시오.

깊이 관계를 드러내는 하나 또는 두 개의 진단 각도를 사용하십시오. 각도 증명이 깊이 교차를 보여주지 않으면 z/카메라/폐색을 개선하십시오.

캔버스 / WebGL

카메라 위치, 카메라 대상, 객체 변환, 재질 불투명도, 셰이더 유니폼, 후처리 강도를 결정론적 상태를 통해 키프레임합니다. HyperFrames 시간에서 렌더링합니다. 마커 상자는 내부 캔버스 모션을 볼 수 없으므로 --ghost를 사용하십시오.

CLI 증명

npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

실제 애니메이션 대상에 대해 <selector>를 선택하십시오. 첫 번째 프레임, 증명 포즈, 최종-마이너스-홀드, 정확한 최종에 대해 <times>를 선택하십시오. 깊이를 증명해야 할 때만 <angle>을 선택하십시오.

도구증명
keyframes대상, 명시적 중지, 경로, 트레이스, 구성된 부모/자식 모션, CSS 중지, Anime 등록
--shot고스트, 경로 모양, 시간 간격, DOM 3D 프로젝션, 집중 선택자 증명
--layout strip제자리 모션, 겹침, 접촉, 미묘한 스케일/불투명도, 텍스트 웨이브
--ghost캔버스, WebGL, 셰이더 모션, 렌더링된 3D
snapshot --at마스크

...

[번역을 위해 잘림]

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

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

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

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.

관련 스킬