Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

디자인 주도의 짧은 모션 그래픽을 제작하는 스킬입니다. 모션 자체가 메시지가 됩니다. (운동 타이포그래피, 통계 카운트업, 차트/데이터 시각화, 로고 스팅/브랜드 록업, 하단 서드/콜아웃/소셜 오버레이, 애니메이션 지도, 애니메이션 트윗/뉴스 기사/헤드라인, 웹페이지/UI 애니메이션, 실제 이미지 형상을 차트로 변환) 일반적으로 10초 이내(최대 약 30초)이며, 내레이션이나 실사 액션 피사체가 없습니다. MP4 또는 투명 오버레이로 렌더링합니다.

hyperframes-instruct란 무엇인가요?

이 스킬은 개발자와 AI 에이전트 사용자를 위해 설계된, **짧고 디자인 주도적인 모션 그래픽** 제작을 자동화하는 전문 도구입니다. `/hyperframes` 진입점을 통해 사용자 의도를 파악하고, 모션 그래픽 워크플로우로 라우팅합니다. 이 워크플로우는 **자율적으로 설계**되어, 한 번의 명확한 질문 후 중간 검토 없이 제작 및 검증까지 진행되며, 렌더링만 사용자 승인을 받습니다. 주요 기능으로는 운동 타이포그래피, 통계 카운트업, 다양한 차트, 로고 리빌, 하단 서드, 지도 애니메이션, 웹페이지/UI 애니메이션, 트윗/뉴스 기사 애니메이션, 이미지 형상을 차트로 융합하는 `asset-fusion` 등 10개 이상의 카테고리를 지원합니다. 각 카테고리는 검색 필요성에 따라 '폼(Form) 카테고리'와 '검색 기반(Search-driven) 카테고리'로 나뉘며, 에이전트는 사용자 제공 콘텐츠 또는 자체 검색을 통해 실제 에셋을 확보한 후, 재사용 우선 방식으로 구성을 진행합니다. 모든 작업 산출물은 `videos/<project-name>/` 디렉토리 아래에 정리되며, `hyperframes` CLI 도구를 통해 초기화, 검증, 스냅샷, 프리뷰, 렌더링 과정을 수행합니다.

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

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

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

문서

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

우선, 이 스킬을 최신 상태로 유지하세요 — 실행 전 사용자에게 확인: npx hyperframes skills update motion-graphics. 모든 것이 최신 상태이면 빠르게 아무 작업도 하지 않습니다. 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 새로 고칩니다.

figma 소스: 빌드할 로고/에셋/애니메이션이 figma.com URL에서 제공되는 경우, 먼저 /figma를 실행하세요 — 에셋 내보내기, 브랜드 토큰, 그리고 그래픽이 Figma Motion 가져오기인 경우 Motion→GSAP 변환을 수행한 후, 그 출력물을 기반으로 빌드합니다. 원시 MCP 도구를 통해 직접 Figma를 구동하지 마세요. SVG 정리, .media/manifest.jsonl 출처 증명, 브랜드 토큰 var() 바인딩을 건너뛰게 되어, 이후 브랜드 변경 시 전체 재가져오기 없이 변경 사항을 전파할 수 없습니다.

motion-graphics — 디스패치 진입점

정문은 /hyperframes입니다. 이 스킬은 짧고, 디자인 주도적이며, 내레이션이 없는 모션 그래픽을 만듭니다 (모션이 메시지이며, 약 10초 미만, 음성 해설 없음). 더 길거나, 내레이션이 있거나, 여러 장면으로 구성된 경우 — 또는 확실하지 않은 경우 → 먼저 /hyperframes를 읽으세요: 의도 레이어가 모든 경로 결정을 소유합니다.

이 워크플로우는 설계상 자율적입니다 — 최대 한 번의 명확한 질문(agents/director.md) 후, 중간 검토 없이 검증을 통해 빌드합니다. 의도 레이어(/hyperframes → references/intent-interview.md)는 런-셰이프 질문 없이 여기로 직접 라우팅합니다. 이러한 짧은 작업에 스토리보드와 동반 세션은 거의 추가되지 않습니다. 렌더링은 여전히 사용자 게이트에 의해 제어됩니다: 검사와 증명 스냅샷이 통과한 후, Studio 미리보기를 열고 ../hyperframes/references/brief-contract.md의 표준 "지금 렌더링할까요, 아니면 변경할 사항이 있나요?" 질문을 합니다. BRIEF.md가 존재하면, 디렉터의 질문 전에 그것을 읽습니다.

짧은 디자인 주도 모션 그래픽. 에셋 우선: 샷을 디자인하기 전에 에셋 전략을 결정하고 실제 자료를 확보한 다음, 가지고 있는 것을 바탕으로 샷을 디자인하고, 카탈로그 기능을 재사용하여 구성합니다. 모든 아티팩트는 PROJECT_DIR = videos/<project-name>/ 아래에 저장됩니다(Step 0에서 생성). 아래 모든 경로는 이 경로를 기준으로 합니다.

단계실행주요 산출물상세 흐름
initBashhyperframes.jsonStep 0
plan서브에이전트 — 검색 결정? + 분류 + 에셋 전략shot-plan.json (초안: 카테고리, asset_needs 쿼리, 브리프)agents/director.md (1부)
source ◇Bash — media-use 해결 (asset_needs가 비어 있으면 건너뜀)assets/ + assets/index.mdphases/source/guide.md
design서브에이전트 — 해결된 에셋을 기반으로 샷 디자인shot-plan.json (최종: 블록 + 레이아웃 + 모션 + 위치)agents/director.md (2부)
build서브에이전트 — 재사용 우선 구성compositions/index.htmlagents/builder.md
verifyBash — lint, check, 증명 스냅샷; 실패 시 수리snapshots/contact-sheet.jpgStep 5
approve미리보기 열기, 렌더링 또는 변경사항 질문, 답변 대기명시적 렌더링 승인Step 6
renderBash — hyperframes render (MP4, 또는 오버레이용 --format webm/mov)renders/video.mp4 또는 투명 오버레이Step 6

◇ source는 선택한 카테고리가 에셋을 선언하는 경우에만 실행됩니다. 순수 코드/텍스트 카테고리(예: kinetic-type, 대부분의 charts/stat)는 asset_needs: []를 가지며 계획에서 디자인으로 바로 넘어갑니다.

카테고리 — 검색 결정에 따른 분할

plan의 첫 번째 결정은: 검색이 필요한가? 입니다. 이 분기는 카테고리를 두 그룹으로 나눕니다. 그런 다음 특정 카테고리가 선택됩니다. 검색 기반의 경우 검색이 반환하는 콘텐츠 유형에 따라 결정됩니다. 각 카테고리는 하나의 categories/<id>/module.md (계획 및 빌드 규칙) 입니다. 공유 모션 어휘는 references/motion-vocabulary.md에 있습니다 (→ hyperframes-animation 규칙/청사진 + 레지스트리 블록).

폼 카테고리 — 검색 없음, 사용자가 콘텐츠 제공:

카테고리의도활용 대상
kinetic-type강렬한 한 줄 / 인용구 / 제목, 모션 우선 텍스트caption-* 블록 + 애니메이션 규칙
stat단일 히어로 숫자 / 카운트업 + 링apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
charts데이터로부터 막대 / 선 / 원 / 경쟁 / % 차트data-chart 블록
logo-reveal로고 스팅 / 브랜드 록업 (사용자 로고)logo-outro / rules/svg-path-draw
lower-thirds이름 / 타이틀 바, 콜아웃, 소셜 오버레이caption-* + 레지스트리 오버레이 블록
maps지리적 모션 — 지역 강조, 장소 연결, 위치로 확대 (벡터 레인 또는 베이크된 베이스맵 레인)us-map / world-map 계열 + bake-basemap.mjs

검색 기반 카테고리 — 먼저 검색한 후 콘텐츠 유형에 따라 애니메이션 적용 (RWA 경로):

반환된 콘텐츠카테고리애니메이션
웹페이지 / 링크webpage웹페이지 / UI 애니메이션 (스크롤, 나타나기, 커서, 콜아웃)
뉴스 기사news헤드라인 나타나기 + 소스 카드 + 주요 사실 콜아웃
트윗tweet애니메이션 트윗 카드
이미지 / 개체asset-fusion에셋의 형상이 차트가 됩니다 (RWA 다이제틱 융합)

빌드 순서: 한 번에 하나씩, 커버리지 우선 (대략적이어도 괜찮음). kinetic-type은 프로토타입에서 포팅되었습니다. 나머지는 그 뒤를 따릅니다.

전제 조건

macOS Apple Silicon 또는 Linux x64. 시스템 도구: brew install node ffmpeg. npx hyperframes doctor 를 한 번 실행합니다. macOS GPU 렌더: export PRODUCER_BROWSER_GPU_MODE=hardware.

선택적 키 (설정되지 않은 경우 로컬 폴백) — media-use를 통해 에셋을 소싱/생성하는 카테고리에만 필요합니다:

키사용처폴백
GEMINI_API_KEY / GOOGLE_API_KEY이미지 생성 (media-use 해결)생성 건너뛰기 / 검색 전용
(asset_scout / 검색 제공자)webpage/news/tweet + asset-fusion 실제 에셋 검색카테고리가 에셋 프리로 저하됨

흐름

0단계 — 초기화

현재 작업 디렉토리는 에이전트 워크스페이스 루트입니다. 모든 아티팩트를 PROJECT_DIR = videos/<project-name>/ 아래에 씁니다. <project-name>: 사용자가 제공한 디렉토리를 사용하거나, 제공되지 않은 경우 의도에서 짧은 케밥-케이스 이름을 사용합니다 (<subject>-motion). 워크스페이스 기본 이름이나 타임스탬프는 사용하지 마세요.

$PROJECT_DIR/hyperframes.json이 없는 경우에만:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init은 설치된 스킬을 GitHub의 최신 버전과 비교하여 오래된 것이 있으면 전역 세트를 업데이트합니다.

제약사항: 워크스페이스 루트에서 hyperframes init을 절대 실행하지 마세요. PROJECT_DIR 안에 다른 hyperframes/를 중첩하지 마세요. 모든 Bash 명령 (마스터 + 서브에이전트)은 (cd "$PROJECT_DIR" && ...) 서브셸입니다 — cd를 직접 사용하지 마세요.

1단계 — 계획 (서브에이전트: 디렉터 1부)

하나의 서브에이전트를 디스패치합니다. 프롬프트 = 전체 agents/director.md + ## Dispatch context (SKILL_DIR / PROJECT_DIR / 사용자 요청 / Schema: <SKILL_DIR>/references/shot-plan-ir.md). 다음을 수행해야 합니다:

  1. 결정: 검색이 필요한가? (첫 번째 분기)
    • 아니오 → 폼 카테고리를 선택합니다 (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps). 콘텐츠는 사용자가 제공합니다. asset_needs: [].
    • 예 → asset_needs[]에 검색 계획을 기록합니다 (뉴스 / 웹 / 트윗 / 이미지; 이중 극 쿼리). 구체적인 검색 기반 카테고리 (webpage / news / tweet / asset-fusion)는 2단계에서 반환된 콘텐츠 유형에 의해 확인되고, 3단계에서 최종 확정됩니다.
  2. 초안 shot-plan.json을 작성합니다 (봉투 + 선택된 폼 카테고리 또는 검색 의도 + asset_needs + 한 문단 분량의 샷 브리프). 스키마: references/shot-plan-ir.md.

검증: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

2단계 — 소싱 ◇ (Bash: media-use, 조건부)

shot-plan.json.asset_needs가 비어 있지 않으면 에셋을 해결합니다 (검색 / 생성 / 가져오기 → 고정된 프로젝트-로컬 경로 + 원장). phases/source/guide.md 참조 ( media-use resolve를 래핑합니다. 검색 기반 카테고리는 뉴스/웹/트윗/이미지 검색을 사용합니다). asset_needs가 비어 있으면 3단계로 건너뜁니다.

우아하게 저하: 검색/제공자가 사용 불가능하면 카테고리는 에셋 프리로 되돌아갑니다 (context.log에 기록).

3단계 — 디자인 (서브에이전트: 디렉터 2부)

서브에이전트를 디스패치합니다 (프롬프트 = agents/director.md 2부 + 2단계가 실행된 경우 해결된 assets/index.md를 포함한 디스패치 컨텍스트 + catalog-map.md). 사용 가능한 에셋을 중심으로 샷을 디자인합니다: 적절한 카탈로그 블록 + hyperframes-animation 규칙/청사진, 레이아웃, 모션, 비트, 그리고 (asset-fusion의 경우) element_positions + 스포이드 팔레트를 선택합니다. shot-plan.json을 최종 확정합니다 (content.block + content.customize + 카테고리별 콘텐츠).

4단계 — 빌드 (서브에이전트: 빌더, 재사용 우선)

공유 모션 원칙을 빌더의 디스패치 컨텍스트에 포함합니다. charts 및 stat의 경우 데이터 인 모션도 포함합니다. 빌더는 타임라인을 작성하기 전에 이 가이드를 읽습니다.

서브에이전트를 디스패치합니다. 프롬프트 = 전체 agents/builder.md + 디스패치 컨텍스트 (shot-plan.json, catalog-map.md, 카테고리의 module.md, references/motion-vocabulary.md, references/builder-contract.md). 재사용 우선: npx hyperframes add <block> + 제자리에서 사용자 정의; 수동 작성은 갭 + 에셋-퓨전 어포던스만 수행합니다. HF 계약을 준수하는 compositions/index.html을 출력합니다 (일시 중지된 GSAP 타임라인 on window.__timelines, class="clip" + 안정적인 ID, tl.seek(0), 결정론적).

5단계 — 검증 (Bash → 실패 시 수리 서브에이전트)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

시작 상태, 시그니처 동작, 최종 홀드를 보여주는 증명 시간을 선택합니다. 계속하기 전에 생성된 연락처 시트 또는 스냅샷 시트를 검사합니다. lint, check 또는 스냅샷 실패 시, 수리 서브에이전트(agents/finalize.md)를 디스패치하여 한 번의 제자리 수정 패스를 수행한 다음, 실패한 게이트를 다시 실행합니다. 결함을 숨기기 위해 고정된 지속 시간을 변경하지 마십시오.

6단계 — 승인 및 렌더링 (Bash)

Studio를 열고 한 가지 질문을 합니다: "지금 렌더링할까요, 아니면 변경할 사항이 있나요?" 수정 후 동일한 게이트로 돌아갑니다:

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

명시적인 렌더링 응답 후에만 렌더링합니다:

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 투명 오버레이 변형: --format webm  (또는 mov)

출력물이 존재하고, 비어 있지 않으며, 의도된 지속 시간인지 확인합니다. 최종 핸드오프는 아티팩트 이름, 실제 지속 시간, 구성 또는 프레임 ID, 증명 시간, 그리고 검사된 연락처 시트 또는 스냅샷 시트를 명시합니다. 플래그는 /hyperframes-cli → references/preview-render.md에 있습니다.

재개 테이블

상태계속 지점
shot-plan.json 없음1단계 (계획)
shot-plan.json에 asset_needs가 있고 assets/ 없음2단계 (소싱)
shot-plan.json 최종, compositions/index.html 없음3/4단계 (디자인+빌드)
compositions/index.html 존재, 증명 스냅샷 없음5단계 (검증)
검사 및 증명 스냅샷 통과, 승인된 렌더링 없음6단계 (승인)
승인된 렌더링 존재출력 확인 후 보고

디자인 노트 (메인테이너 — 실행은 이 내용을 읽지 않음)

  • 에셋 우선 합리화

…

[번역을 위해 잘림]

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

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.

관련 스킬