Communitygithub.com

모션 그래픽 — 바로 가기

사용자가 짧고 디자인 중심의 모션 그래픽을 원할 때 사용합니다. 모션이 곧 메시지입니다: 운동 타이포그래피, 숫자 카운트업, 차트/데이터 시각화 히트, 로고 스팅, 브랜드 록업, 하단 써드, 콜아웃, 소셜 오버레이, 애니메이션 헤드라인/트윗/뉴스 아이템, 모션 포스터, 또는 빠른 캡처 페이지 하이라이트 등. 일반적으로 10초 미만에서 최대 30초 사이이며, 내레이션 아크, 음성 해설, 실사 주제가 없습니다. MP4 또는 투명 오버레이로 렌더링할 수 있습니다. 더 길고, 여러 장면이 있거나, 내레이션이 있거나, 브랜드 릴 형태의 작업은 general-video, 내레이션이 있는 웹사이트 비디오는 website-to-video, 주제 설명은 faceless-explainer, 제품 프로모션은 product-launch-video, PR 비디오는 pr-to-video, 기존 영상에 자막 추가는 embedded-captions를 사용하세요. 빠른 모션 우선 작업인지 더 길거나 내레이션이 필요한 작업인지 확실하지 않다면 /hyperframes를 참조하세요.

모션 그래픽 — 바로 가기란 무엇인가요?

이 스킬은 짧고 디자인 중심의 모션 그래픽을 제작하기 위한 전문 AI 에이전트 디스패치 항목입니다. 모션 자체가 메시지가 되는 작업(10초 미만, 음성 해설 없음)에 최적화되어 있으며, 더 길거나 여러 장면, 내레이션이 필요한 작업은 /general-video, /website-to-video, /faceless-explainer 등 다른 디스패치 항목으로 안내합니다. 이 스킬은 '에셋 우선' 접근 방식을 따릅니다. 먼저 에셋 전략을 결정하고 실제 자료를 확보한 다음, 샷을 디자인하고, 카탈로그 기능을 재사용하여 컴포지션을 구성합니다. 모든 작업은 `videos/<project-name>/` 디렉토리에 저장됩니다. 주요 단계는 계획(서브 에이전트: Director), 소싱(조건부 Bash), 디자인(Director 2부), 빌드(서브 에이전트: Builder, 재사용 우선), 렌더링(Bash: hyperframes render), 검증(Bash: lint/inspect) 및 수리로 이루어집니다. 이 스킬은 macOS Apple Silicon 또는 Linux x64에서 실행되며, `kinetic-type`, `stat`, `charts`, `logo-reveal`, `lower-thirds`, `webpage`, `news`, `tweet`, `asset-fusion` 등 다양한 카테고리를 지원합니다. 각 카테고리는 검색 필요 여부에 따라 분류되며, 검색이 필요한 경우 news/web/tweet/image 검색을 통해 실제 에셋을 확보합니다. 최종 출력물은 MP4 또는 투명 오버레이(WebM/MOV) 파일입니다.

지원 대상~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/tree/HEAD/.agents/skills/motion-graphics

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

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

문서

모션 그래픽 — 디스패치 항목

Step 0 이전에 경로를 확인하세요. 이 스킬은 짧고, 디자인 중심이며, 내레이션이 없는 모션 그래픽(모션이 메시지이며, 약 10초 미만, 음성 해설 없음)을 만듭니다. 더 길거나, 여러 장면이 있거나, 내레이션이 있는 작업 → /general-video; 웹사이트의 내레이션 비디오 → /website-to-video; 주제 설명 → /faceless-explainer; 제품 프로모션 → /product-launch-video; 기존 영상에 자막 추가 → /embedded-captions. 범위 외: 실시간/렌더링 시 데이터, 또는 캡처할 수 없는 푸티지. 모션 우선인지 내레이션이 필요한지 확실하지 않다면? 먼저 /hyperframes를 읽으세요.

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

단계실행기본 아티팩트상세 흐름
initBashhyperframes.jsonStep 0
plan서브 에이전트 — 검색 결정? + 분류 + 에셋 전략shot-plan.json (초안: 카테고리, asset_needs 쿼리, 브리핑)agents/director.md (1부)
source ◇Bash — media-use resolve (asset_needs가 비어 있으면 건너뜀)assets/ + assets/index.mdphases/source/guide.md
design서브 에이전트 — 확보된 에셋을 기반으로 샷 디자인shot-plan.json (최종: 블록 + 레이아웃 + 모션 + 위치)agents/director.md (2부)
build서브 에이전트 — 재사용 우선 컴포지션compositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, 또는 오버레이는 --format webm/mov)renders/video.mp4Step 5
verifyBash — lint / inspect -> 실패 시 수리 서브 에이전트 디스패치(제자리 수정)agents/finalize.md

◇ 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-* + 레지스트리 오버레이 블록

검색 주도형 카테고리 — 먼저 검색한 다음 콘텐츠 유형에 따라 애니메이션(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 resolve)생성 건너뛰기 / 검색 전용
(asset_scout / 검색 제공자)webpage/news/tweet + asset-fusion 실제 에셋 검색카테고리가 에셋 없이 작동

흐름

Step 0 — 초기화

현재 작업 디렉토리(cwd)는 에이전트 워크스페이스 루트입니다. 모든 아티팩트를 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

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

제약 조건: 워크스페이스 루트에서 hyperframes init을 절대 실행하지 마세요. PROJECT_DIR 내부에 다른 hyperframes/를 중첩하지 마세요. 모든 Bash 명령(마스터 + 서브 에이전트)은 (cd "$PROJECT_DIR" && ...) 서브쉘입니다. 절대 cd를 단독으로 사용하지 마세요.

Step 1 — 계획 (서브 에이전트: Director 1부)

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

  1. 결정: 검색이 필요한가? (첫 번째 분기)
    • 아니요 → 폼 카테고리(kinetic-type / stat / charts / logo-reveal / lower-thirds)를 선택합니다. 콘텐츠는 사용자 제공; asset_needs: [].
    • 예 → 검색 계획을 asset_needs[](news / web / tweet / image; 양극 쿼리)에 내보냅니다. 특정 검색 주도형 카테고리(webpage / news / tweet / asset-fusion)는 Step 2에서 반환된 콘텐츠 유형에 의해 확인되고 Step 3에서 최종 확정됩니다.
  2. 초안 shot-plan.json(엔벨로프 + 선택한 폼 카테고리 또는 검색 의도 + asset_needs + 한 문단 분량의 샷 브리핑)을 작성합니다. 스키마: references/shot-plan-ir.md.

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

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

shot-plan.json.asset_needs가 비어 있지 않으면 에셋을 해결합니다(검색/생성/가져오기 → 고정된 프로젝트-로컬 경로 + 원장). phases/source/guide.md 참조(media-use resolve를 래핑하며, 검색 주도형 카테고리는 news/web/tweet/image 검색을 사용). asset_needs가 비어 있으면 Step 3으로 건너뜁니다.

# 설명용 — phases/source/guide.md 참조
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

우아하게 저하: 검색/제공자를 사용할 수 없는 경우 카테고리는 에셋 없이 작동합니다(context.log에 기록).

Step 3 — 디자인 (서브 에이전트: Director 2부)

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

Step 4 — 빌드 (서브 에이전트: Builder, 재사용 우선)

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

Step 5 — 렌더링 (Bash)

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

Step 6 — 검증 (Bash → 실패 시 수리 서브 에이전트 디스패치)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 완료. lint/inspect 오류 발생 시 수리 서브 에이전트 디스패치(agents/finalize.md: 스냅샷 QA + 한 번의 제자리 수정 패스 + 재렌더링). 수리에서 고정된 지속 시간을 절대 변경하지 마세요.

보고 + 선택적 미리보기

최종 출력(renders/video.mp4 또는 .webm / .mov 오버레이 변형) + 지속 시간을 보고합니다. 실행 중에는 미리보기를 열지 마세요. 요청 시에만 제공하며, 렌더링 이후에 시작하여 최종 파일을 제공하도록 합니다:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI; 또는 공유 가능한 링크의 경우 `npx hyperframes play`

플래그는 hyperframes-cli 스킬(references/preview-render.md)에 있습니다.

재개 테이블

상태계속 진행 위치
shot-plan.json 없음Step 1 (계획)
shot-plan.json에 asset_needs 있고, assets/ 없음Step 2 (소싱)
shot-plan.json 최종, compositions/index.html 없음Step 3/4 (디자인+빌드)
compositions/index.html 있고, renders/video.mp4 없음Step 5 (렌더링) + Step 6
renders/video.mp4 있음보고 + 중지

디자인 노트 (유지보수 담당자 — 실행 시 이 내용을 읽지 않음)

  • 에셋 우선 근거: 소싱은 프론트-로드되어 샷 디자인에 정보를 제공합니다(RWA 흐름: 분석 → 검색 → 검토 → 구성). 검색 주도형 카테고리(webpage/news/tweet)와 asset-fusion 모두 media-use 검색(news/web/tweet/image)에 의존하며, 이는 media-use의 문서화된 RWA 계보입니다.
  • 재사용 우선: 생태계 내에서 LLM 생성 템플릿에 해당하는 것은 "카탈로그 블록 구성 + hyperframes-animation 규칙"입니다. HF의 일시 정지된 GSAP 타임라인은 Remotion의 useCurrentFrame과 유사합니다.
  • 카테고리 모듈 계약: 하나의 categories/<id>/module.md(계획 + 빌드), references/motion-vocabulary.md 공유(+ 선택적 eval). 카테고리 추가 = 폴더를 드롭하고 agents/director.md에 분류 행과 catalog-map.md에 행을 등록합니다. 단계 파이프라인은 변경되지 않습니다.
  • 디렉토리 구조:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR (Director 출력)
      assets/  assets/index.md  # media-use 출력 (소싱된 경우)
      compositions/index.html   # Builder 출력
      renders/video.mp4
    
  • 등록: hyperframes 라우터에서 — "디자인 주도형 짧은 모션 그래픽" 의도 + 워크플로 설명 추가; /general-video에서 모션 그래픽 트리거를 분리; 역 DO-NOT-use 엣지 추가. motion-graphics-genre.md §5-7 참조.

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

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

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

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-nextjs

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

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

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

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

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

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

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

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

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

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.

관련 스킬