Communitygithub.com

모션그래픽 — 디스패치 엔트리

사용자가 운동 자체가 메시지인 짧고 디자인 중심의 모션 그래픽(키네틱 타이포그래피, 숫자 카운트업, 차트/데이터 시각화, 로고 스팅, 브랜드 잠금, 하단 1/3, 콜아웃, 소셜 오버레이, 애니메이션 헤드라인/트윗/뉴스, 모션 포스터, 빠른 캡처 페이지 하이라이트)을 원할 때 사용합니다. 일반적으로 10초 미만에서 최대 약 30초이며, 내레이션 구성, 음성 해설, 실사 피사체가 없습니다. MP4 또는 투명 오버레이로 렌더링할 수 있습니다. 더 길고, 다중 장면, 내레이션이 있는 브랜드 릴(일반 비디오 사용), 내레이션이 있는 웹사이트 비디오(website-to-video), 주제 설명(faceless-explainer), 제품 프로모션(product-launch-video), 홍보 비디오(pr-to-video), 기존 푸티지의 캡션(embedded-captions)에는 사용하지 마십시오. 빠른 모션 우선 작업인지 더 길거나 내레이션이 있는 작업인지 확실하지 않으면 /hyperframes를 참조하십시오.

모션그래픽 — 디스패치 엔트리란 무엇인가요?

이 스킬은 짧고 디자인 중심의 내레이션이 없는 모션 그래픽을 제작하기 위한 전문 디스패치 진입점입니다. 키네틱 타이포그래피, 숫자 카운트업, 데이터 차트, 로고 리빌, 하단 1/3, 웹페이지 UI 애니메이션, 뉴스 기사, 트윗 카드 등 다양한 카테고리를 지원하며, 각각 고유한 계획 및 제작 규칙을 따릅니다. 이 스킬은 '에셋 우선' 접근 방식을 사용하여, 샷을 디자인하기 전에 먼저 에셋 전략을 결정하고 실제 자료를 소싱한 다음, 카탈로그 블록을 재사용하여 구성을 조합합니다. macOS Apple Silicon 또는 Linux x64에서 실행되며, Node.js, ffmpeg 및 hyperframes CLI 도구가 필요합니다. 전체 워크플로우는 초기화, 계획(에셋 필요 여부에 따라 검색 여부 결정), 소싱(필요한 경우 미디어 검색/생성), 디자인, 빌드(재사용 우선), 렌더링(MP4 또는 투명 오버레이), 검증(린트 및 검사) 단계로 구성됩니다.

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

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

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

문서

모션그래픽 — 디스패치 진입점

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

짧고 디자인 중심의 모션 그래픽입니다. 에셋 우선: 샷을 디자인하기 전에 에셋 전략을 결정하고 실제 자료를 소싱한 다음, 보유한 자료를 기준으로 샷을 디자인하고, 카탈로그 기능을 재사용하여 구성합니다. 모든 아티팩트는 PROJECT_DIR = videos/<project-name>/(0단계에서 생성)에 저장됩니다. 아래 모든 경로는 이 디렉토리를 기준으로 합니다.

단계실행주요 아티팩트상세 흐름
initBashhyperframes.json0단계
계획서브에이전트 — 검색 결정? + 분류 + 에셋 전략shot-plan.json (초안: 카테고리, asset_needs 쿼리, 브리프)agents/director.md (1부)
소싱 ◇Bash — 미디어 사용 해결 (asset_needs가 비어 있으면 건너뜀)assets/ + assets/index.mdphases/source/guide.md
디자인서브에이전트 — 해결된 에셋을 기반으로 샷 디자인shot-plan.json (최종: 블록 + 레이아웃 + 모션 + 위치)agents/director.md (2부)
빌드서브에이전트 — 재사용 우선 구성compositions/index.htmlagents/builder.md
렌더링Bash — hyperframes render (MP4, 오버레이는 --format webm/mov)renders/video.mp45단계
검증Bash — lint / inspect -> 실패 시 복구 서브에이전트(수정 사항은 그 자리에서)agents/finalize.md

◇ 소싱 단계는 선택된 카테고리가 자산을 선언할 때만 실행됩니다. 순수 코드/텍스트 카테고리(예: kinetic-type, 대부분의 charts/stat)는 asset_needs: []를 가지며 계획에서 바로 디자인으로 건너뜁니다.

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

계획의 첫 번째 결정은: 검색이 필요한가? 입니다. 이 분기는 카테고리를 두 그룹으로 나눕니다. 그런 다음 특정 카테고리가 선택됩니다. 검색 기반의 경우 검색이 반환하는 콘텐츠 유형에 따라 선택됩니다. 각 카테고리는 하나의 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.

선택적 키(설정되지 않은 경우 로컬 폴백) — 미디어 사용을 통해 자산을 소싱/생성하는 카테고리에만 필요:

키용도폴백
GEMINI_API_KEY / GOOGLE_API_KEY이미지 생성 (미디어 사용 해결)생성 건너뛰기 / 검색 전용
(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

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)를 선택합니다. 콘텐츠는 사용자가 제공합니다. asset_needs: [].
    • 예 → 검색 계획을 asset_needs[](news / web / tweet / image; 양극 쿼리)에 내보냅니다. 특정 검색 기반 카테고리(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를 래핑하며, 검색 기반 카테고리는 news/web/tweet/image 검색을 사용함)을 참조하십시오. asset_needs가 비어 있으면 3단계로 건너뜁니다.

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

정상 저하: 검색/제공자를 사용할 수 없으면, 카테고리는 에셋이 없는 상태로 폴백됩니다(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단계 — 빌드 (서브에이전트: 빌더, 재사용 우선)

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

5단계 — 렌더링 (Bash)

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

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 없음1단계 (계획)
shot-plan.json에 asset_needs 있음, assets/ 없음2단계 (소싱)
shot-plan.json 최종, compositions/index.html 없음3/4단계 (디자인+빌드)
compositions/index.html 있음, renders/video.mp4 없음5단계 (렌더링) + 6단계
renders/video.mp4 있음보고 + 중지

설계 노트 (유지보수자 — 실행 시 이 내용을 읽지 않음)

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

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

관련 스킬