Communitygithub.com

1999AZZAR/designer-mcp

필수 진입점: 비디오, 애니메이션, 모션 그래픽 제작, 생성, 편집, 애니메이션, 렌더링 요청 시 가장 먼저 읽어야 합니다. 프로모션, 설명 영상, 자막 클립, 타이틀 카드, 오버레이, 슬라이드쇼, 인터랙티브 데크, Remotion 포트, 또는 HyperFrames HTML 컴포지션 등 모든 요청에 사용합니다. 또한 기존 HyperFrames 프로젝트를 검사, 진단, 검증, 미리보기, 게시 또는 배치 렌더링할 때도 사용합니다.

designer-mcp란 무엇인가요?

이 스킬은 HyperFrames 프레임워크의 필수 진입점입니다. HyperFrames는 HTML로 비디오를 렌더링하는 시스템으로, `data-*` 속성을 사용하여 DOM에 타이밍을 선언하고 애니메이션 런타임을 탐색 가능하게 하며 미디어 재생을 프레임워크가 제어합니다. 이 스킬은 프로젝트 상태를 재개하고, 의도를 캡처하며, 적절한 작업 흐름을 선택하고 설치한 후 도메인 역량을 라우팅합니다. 주요 기능으로는 프로젝트 상태 기반 라우팅(기존 프로젝트 편집, 신규 생성, Remotion 포트 등), 의도 인터뷰를 통한 신규 생성 라우팅, CLI 업그레이드 관리, 그리고 필요 시 도메인 스킬(코어, 애니메이션, 키프레임, 크리에이티브, 미디어, 오디오, CLI, 레지스트리, Figma 등)을 로드하는 것이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex 및 유사한 AI 에이전트 플랫폼과 함께 사용하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/hyperframes

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

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

문서

HyperFrames 진입점

HyperFrames는 HTML로 비디오를 렌더링합니다. 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임을 탐색할 수 있으며, 미디어 재생을 프레임워크가 소유하는 HTML 파일입니다. 전체 제작 규약은 /hyperframes-core에 있습니다. 컴포지션 HTML을 작성하기 전에 이를 읽으십시오. 브리프, 스토리보드, 리뷰, 제작, 디스패치 및 프레임 워커 규약은 이 스킬의 references/ 디렉토리에 있습니다.

1. 프로젝트 상태에서 시작

일치하는 첫 번째 행을 적용하고, 하위 상태 행은 평가하지 마십시오:

상태작업
기존 Remotion 소스를 HyperFrames로 명시적으로 포팅references/routes/remotion-to-hyperframes.md를 읽은 후 해당 워크플로우로 직접 라우팅합니다. 의도 레이어를 건너뜁니다.
기존 HyperFrames 프로젝트에 대한 특정 작업: 검사, 진단, 검증, 미리보기, 렌더링, 게시 또는 배치 렌더링해당 작업만 수행합니다. 의도 및 워크플로우 라우팅을 건너뜁니다. /hyperframes-cli 및 필요한 도메인 스킬을 로드합니다.
기존 프로젝트에 대한 특정 편집편집을 수행합니다. 의도 레이어를 실행하지 마십시오. 프로젝트 타임라인(트랙, 클립, 시작, 종료, 재생 내용)을 확인하려면 index.html 및 모든 하위 컴포지션 파일을 읽는 대신 npx hyperframes timeline [--json]을 실행하십시오.
BRIEF.md가 존재함workflow 및 flow를 읽습니다. 해당 워크플로우를 실행합니다. flow: companion은 항상 /general-video에서 실행됩니다. 브리프 질문을 하지 마십시오.
브리프는 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함프로젝트 파일 및 기록된 선호도에서 재개합니다. 기존 아티팩트에서 소유 워크플로우를 유추합니다. 고유하게 결정할 수 없는 경우 라우팅 전용 질문을 하나만 하고, 의도 인터뷰를 실행하지 마십시오.
새로 생성의도 레이어(references/intent-interview.md)를 실행한 후 § 2의 표를 사용하여 한 번 라우팅합니다.

새 요청이 주제나 입력을 식별하지 못하는 경우, 라우팅하기 전에 비디오가 무엇에 관한 것인지 물어보십시오. 질문하기 전에 기본 설정과 레시피를 확인하십시오(references/intent-interview.md, 1단계). figma.com 입력 또는 명명된 레시피는 인테이크를 변경할 뿐 라우팅은 변경하지 않습니다. 인터뷰의 "직교 입력 적용" 섹션이 둘 다 처리합니다.

프로젝트의 CLI를 최신 상태로 유지

스캐폴딩된 프로젝트는 package.json 스크립트에 hyperframes@<버전>을 고정하여 렌더링이 재현 가능하도록 합니다. 이 고정은 자체적으로 업데이트되지 않으며, 이전 CLI의 고정된 실행은 이에 대해 경고를 출력하지 않습니다. 스크립트에 고정이 있는 프로젝트를 재개할 때, 첫 번째 렌더링 영향 명령 전에 한 번 검사하십시오:

npx hyperframes@latest upgrade --project . --check

이 검사는 읽기 전용이며 고정된 버전과 최신 릴리스를 비교합니다. 명시적인 .를 유지하십시오. 이전 CLI 릴리스에서 --project 뒤에 다른 플래그가 오면 해당 플래그를 디렉토리 값으로 사용합니다. 프로젝트가 뒤쳐졌다고 보고하거나(또는 CLI 출력에 이미 표시된 경우, stderr 알림 이 프로젝트는 hyperframes@…(최신 …)을 고정합니다 또는 고정된 스크립트의 --json 결과에서 _meta.updateAvailable: true) npx hyperframes@latest upgrade --project .를 적용한 후 npx hyperframes check로 확인하십시오. 통과된 확인은 프로젝트의 컴포지션이 새 버전에서 여전히 유효함을 확인합니다(렌더링 출력이 이전 고정과 프레임이 동일함을 의미하지는 않음). 따라서 성공적인 업데이트는 절대 조용히 이루어지지 않습니다. 실행 요약에 이전 및 새 버전을 명시하십시오. 아직 컴포지션이 없는 프로젝트는 확인이 필요하지 않습니다. 확인에 실패하면 package.json 변경을 되돌리고, 고정된 버전을 계속 사용하며, 프로젝트가 어떤 버전에 남아 있고 그 이유를 보고하십시오. 신호를 사용자에게 전달하지 말고 신호에 따라 행동하십시오. 업데이트된 고정을 확인되지 않은 상태로 두지 마십시오.

2. 새 생성 라우팅

첫 번째 일치하는 행을 사용하십시오. 요청된 결과물을 일치시키고, 지나가는 말로 언급된 단어나 파일 형식이 아닙니다.

우선순위요청워크플로우
1기존 Remotion 소스를 명시적으로 포팅/remotion-to-hyperframes
2프레젠테이션, 피치 데크 또는 탐색 가능한 인터랙티브 데크 제작/slideshow
3기존 토킹헤드 영상에 일반 자막 또는 자막 추가(영상 변경 없이)/embedded-captions
4기존 토킹헤드, 인터뷰 또는 팟캐스트 영상에 디자인된 그래픽 오버레이 추가(영상 변경 없이)/talking-head-recut
5음악 트랙에서 비트 동기화 비디오 제작(내레이션 또는 웹사이트 캡처 없이)/music-to-video
6명시적으로 짧고, 내레이션이 없으며, 모션 중심의 단위(일반적으로 10초 미만) 생성/motion-graphics
7PR 참조에서 GitHub 풀 리퀘스트 또는 코드 변경 설명/pr-to-video
8URL 또는 사이트별 브리프에서 웹사이트, 제품 사이트, 앱 또는 회사 마케팅 또는 홍보/product-launch-video
9발명된 시각 자료와 제품 또는 사이트 캡처 없이 주제, 기사 또는 노트 설명/faceless-explainer
10기타 모든 사용자 정의 비디오 또는 컴포지션/general-video

라우팅을 최종 확정하기 전에 references/routes/<워크플로우>.md를 읽으십시오. 각 경로당 하나의 작은 파일: 지연 설치 워크플로우 스킬이 있기 전에 사용 가능한 정식 입력/출력/트리거 규약과 해당 경로의 인터뷰 항목입니다. 후보가 해당 규약을 충족하지 않으면 강제로 일치시키는 대신 계속 라우팅하십시오. 일치하는 경로의 파일만 읽으십시오.

일반적인 모호성 해결

  • 짧은 애니메이션 타이틀, 로고 스팅, 통계 히트, 차트 히트, 지도 히트 또는 독립형 하단 서드는 내레이션이 없고 모션이 메시지인 경우 /motion-graphics입니다. 정적 타이틀 카드, 내레이션이 있는 시퀀스, 더 긴 몽타주 또는 사용자 정의 루프는 /general-video입니다.
  • 명시적으로 짧은 모션 그래픽은 URL, 트윗, 기사 또는 스크린샷을 소스 자료로 사용할 수 있습니다. "이 사이트에서 비디오 만들기"와 같은 일반적인 요청은 /product-launch-video입니다.
  • 자막이 있는 기존 영상은 /embedded-captions로 라우팅되고, 디자인된 정보 카드가 있는 영상은 /talking-head-recut으로 라우팅됩니다. 영상의 리타이밍, 재정렬, 재채색, 재프레이밍 또는 리믹스는 사용자 정의 편집이며 /general-video로 넘어갑니다.
  • 음악 파일은 비트 그리드가 작품을 구동하는 경우에만 /music-to-video를 선택합니다. 배경 음악으로 사용된 음악은 주제 일치 경로를 재정의하지 않습니다.
  • "스토리보드를 원합니다"는 워크플로우가 아닌 검토 프로세스를 변경합니다. 다른 라우팅 신호가 없으면 /general-video를 사용하십시오. 확정된 스케치 storyboard.html 자체가 요청된 결과물일 수 있습니다. 검토 루프가 해당 중지 지점을 정의합니다.
  • 특수 내러티브 워크플로우는 최대 약 3분을 지원하며 30-90초에서 가장 강력합니다. 분명히 더 긴 작품은 /general-video로 라우팅하십시오. 길이는 명시적 포트, 데크, 자막, 오버레이 또는 음악 구동 결과물을 재정의하지 않습니다.

3. 한 번 라우팅한 후 종료

새 생성의 경우 의도 레이어(references/intent-interview.md)가 전체 대화(메모리, 분류, 피치 라운드, 필수 사항, 실행 형태, 핸드오프)를 실행하고 BRIEF.md 작성으로 종료합니다. 브리프는 워크플로우가 읽는 유일한 라우팅 아티팩트입니다. 이후에 이 스킬이나 인터뷰를 다시 열지 않습니다. "경로가 요구한 것"에 대한 모든 후속 질문은 BRIEF.md에서 답변하십시오.

4. 워크플로우 설치 및 진입

선택한 워크플로우를 읽기 전에 설치하거나 새로 고치고 핵심 도메인 스킬을 설치하십시오:

npx hyperframes skills update <워크플로우 이름>

/ 없이 기본 이름을 사용하십시오. 명령이 실패하면 오류를 표시하고, 메모리에서 워크플로우를 재구성하지 마십시오. 설치에 관한 다른 모든 것(코어 대 지연 분할, init이 새로 고치는 것, 진단, CI 옵트아웃 및 CLI 없음 대체)은 references/skill-lifecycle.md에 있습니다.

5. 필요 시 도메인 스킬 로드

필요 사항스킬
컴포지션 구조, 타이밍 속성, 트랙, 변수, 결정론/hyperframes-core
모션 규칙, 씬 청사진, 전환, 런타임 어댑터/hyperframes-animation
검색 가능 GSAP, CSS, Anime.js, WAAPI, FLIP, 패스, 마스크, SVG, 3D 키프레임 또는 hyperframes keyframes 진단/hyperframes-keyframes
디자인 사양, 컨셉, 팔레트, 타이포그래피, 내레이션, 비트 계획/hyperframes-creative
이미지, 아이콘, 로고, 오디오, 자막, 그레이딩, LUT, 재사용 가능한 미디어/media-use
보이스오버 컷, 오디오 이펙트 체인, 자동화 엔벨로프 또는 여러 트랙에 걸친 하나의 체인/페이더(서브믹스 버스)/hyperframes-audio
초기화, 린트, 확인, 스냅샷, 비교, 배치 렌더링, Studio, 렌더링, 게시 또는 진단/hyperframes-cli
레지스트리 블록 및 컴포넌트/hyperframes-registry
명명된 룩, 효과, 처리 또는 전환(CRT 스캔라인, 글리치, 필름 그레인, 샤이머 스윕, 컨페티 버스트) - 직접 제작하기 전에/hyperframes-registry
재구성된 모션으로서의 Figma 에셋, 토큰, 컴포넌트 또는 스토리보드 프레임/figma

제작자 편집 구문은 교차 도메인 요청입니다. 일치하는 행에 명명된 모든 스킬을 로드하십시오:

제작자 요청필요한 도메인
"이 영상 잘라내기", 하드 컷, 트림, 스플라이스, 재정렬 또는 소스 범위 사용/general-video + /hyperframes-core; 코어가 data-start, data-duration, data-media-start 및 트랙 레이아웃을 소유합니다.
여기 확대, 펀치인/펀치아웃, 부드러운 다중 상태 확대/축소 또는 재프레이밍, Ken Burns 또는 카메라 이동/general-video + /hyperframes-core + /hyperframes-keyframes; 시간 제한 클립이 아닌 내부 시각적/크롭 래퍼에 애니메이션을 적용합니다.
매치 컷 또는 휩 팬 카메라 전환/general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry; 직접 작성하기 전에 전환 프리미티브를 검색/설치합니다.
페이드, 크로스페이드, 트랙 게인/볼륨, 자동화, 덕/컷, 오디오 효과 또는 여러 트랙에 걸친 하나의 효과/general-video + /hyperframes-core + /hyperframes-audio; 코어가 클립을 배치하고 오디오가 배치된 트랙을 믹스합니다. 그룹에 대한 서브믹스 버스를 포함합니다.
그림과 사운드 편집으로 컷과 카메라 모션 또는 믹싱 결합/general-video + /hyperframes-core + /hyperframes-keyframes + /hyperframes-audio; 각 클립에 개별적으로 분리하지 않고 복합 트랙에서 작업합니다.

같은 요청에 수평(카메라) 및 수직(타임라인) 편집이 혼합된 경우, 타임라인 전체를 재배열하기 전에 타임라인 편집을 확인하십시오.

6. 크리에이티브 서약

이 스킬의 프롬프트는 수렴하고 있습니다. 모든 영상을 최대한 시각적으로 풍부하게 만드십시오. 기본 설정에 대한 엄격한 해석은 피하고, 항상 크리에이티브 엔진과 함께 조향하십시오. 의도 인터뷰는 디자인 방향을 협상하는 도구입니다. 다음을 수행하십시오:

  • 모든 곳에서 멈춤이 없는 원활한 방향을 선택하십시오.
  • 타이포그래피에서도 뛰어난 자산을 제작하십시오.
  • 프로덕션을 되풀이하십시오.
  • 모든 시청자의 유지율을 위한 모션 전략을 일치시키십시오.
  • 그렇지 않으면 활기를 불어넣으십시오.

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: 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`.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

1999AZZAR/designer-mcp

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.

관련 스킬