Communitygithub.com

1999AZZAR/designer-mcp

미디어 OS: HyperFrames 프로젝트의 BGM, SFX, 이미지, 아이콘, 브랜드 로고, 음성, 컬러 그레이딩, LUT 등 모든 미디어를 통합 관리합니다. resolve(검색), generate(생성), operate(편집)을 하나의 스킬로 처리하며, 미디어 재사용과 감정적 피드백 처리까지 지원합니다.

designer-mcp란 무엇인가요?

`designer-mcp`는 HyperFrames 프로젝트를 위한 미디어 전담 AI 에이전트 스킬입니다. 이 스킬은 BGM, SFX, 이미지, 아이콘, 로고, 음성 (TTS), 컬러 그레이딩, LUT 등 모든 유형의 미디어를 `resolve`라는 단일 동사로 통합 관리합니다. 주요 기능은 크게 네 가지로 나뉩니다: (1) **Resolve**: HeyGen 카탈로그 등에서 기존 미디어를 검색/재사용하거나, (2) **Generate**: TTS/음악/이미지 생성 모델을 통해 새로운 미디어를 생성하며, (3) **Operate**: 미디어 자르기, 리프레임, 변환 등의 편집 작업을 수행하고, (4) **Remember**: 프로젝트 간 에셋을 재사용할 수 있도록 기록합니다. 특히, 사용자가 사진/영상에 대해 '어둡다', '평범하다', '레트로 느낌' 등 모호한 시각적 피드백을 주면, `media-treatments` 참조 문서를 통해 적절한 보정, 프리셋, 셰이더 효과, 키프레임 애니메이션 등을 조합하여 맞춤형 미디어 처리를 제안하고 적용합니다. Claude Code, Cursor 등 AI 에이전트 환경에서 작동하며, `heygen` CLI 설치/인증 후 `npx hyperframes media-use resolve --doctor`로 헬스 체크를 수행합니다. 이 스킬은 불필요한 미리 변경을 하지 않고, 구체적인 신호가 있을 때만 사용자에게 명확한 제안을 한 번만 하도록 설계되어 개발 워크플로우의 정확성과 효율성을 높입니다.

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

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

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

문서

미디어 사용

HyperFrames를 위한 미디어 OS: 검색 · 생성 · 편집 · 기억 — 모든 미디어 유형, 하나의 스킬, 컨텍스트 노이즈 제로.

첫 실행: heygen CLI 설치 및 로그인(무료 사용 경로) 후 npx hyperframes media-use resolve --doctor로 확인. 설정 및 공급자: references/setup-providers.md.

Resolve — 단일 동사

npx hyperframes media-use resolve --type <type> --intent "<설명>" --project <dir>

한 줄 반환: resolved <id> → <path> (<type>, <metadata>). 모든 검색 노이즈는 디스크에 남습니다.

유형한 줄 의도
bgm배경 음악 (HeyGen 카탈로그, 1만 개 이상 트랙)
sfx음향 효과 (번들 19개 파일 라이브러리 + 카탈로그)
image사진, 배경 (HeyGen 에셋 검색, 7만 5천 개 이상 벡터)
icon아이콘, 심볼 (투명)
logo공식 브랜드 마크 (theSVG → GitHub 아바타 → 파비콘; 다시 그리지 않음)
voiceTTS 음성 해설 (HeyGen 무료 사용 경로; 선택적 로컬 Kokoro)
grade측정된 보정 후보; 광범위한 다듬기/스타일화는 미디어 처리를 따름
lut사용자가 제공하거나 명시적으로 선택한 재사용 가능한 검증된 .cube 파일

새로 검색하기 전에 --candidates로 재사용 가능한 후보를 확인하고 직접 적합성을 판단하세요. 재사용 규칙, 모든 플래그, ingest (--from), 채택은 references/resolve.md에 있습니다.

광범위한 시각적 피드백을 미디어 의도로 처리

사용자가 사진/영상 미디어에 대해 명시적으로 수정, 다듬기, 스타일화, 가리기, 강조, 또는 공개를 요청하면, 컬러 그레이딩이나 효과를 언급하지 않더라도 references/media-treatments.md를 읽으십시오. 실제 <img>/<video>를 검사하고, 하나의 기본 의도를 선택한 후, 결정론적 지속성과 검증을 사용하십시오. 일치하는 레시피를 선택적 테스트 시드로 사용하거나, hyperframes media-treatment --capabilities --json을 검사한 후 관련 계열/효과를 --capability <id>로 요청하고 표준 컨트롤로 커스텀 처리를 조립하십시오. 일반적인 저작 작업에는 --all을 로드하지 마십시오. 처리는 보정, 프리셋, 피니싱, 호환 가능한 셰이더 효과, 지원되는 키프레임, 선택적 Registry 오버레이를 구성할 수 있습니다. 소스로 정당화된 제한된 조정과 호환 가능한 부분만 추가하고, 결과를 더 정교하게 보이게 하기 위한 효과만 추가하지 마십시오. 최종 결합된 페이로드는 hyperframes media-treatment로 유지하십시오.

점진적으로 확장되는 하나의 워크플로우를 사용하십시오. 비디오의 경우 프레임을 개별적으로 읽지 말고 레이블이 지정된 초기/중간/후반 콘택트 시트 하나를 검사하십시오. 일반적인 보정 또는 다듬기의 경우 후보를 하나 적용하고 애프터 시트를 검사하십시오. 결과가 모호하거나, 시간적이거나, 스타일화되거나, LUT 기반이거나, HDR/LOG 민감, 비공개, 또는 브랜드에 중요한 경우에만 개별 프레임 또는 움직이는 초안 증거로 확장하십시오.

일반적인 보정 또는 다듬기의 경우 최종 처리의 프리셋/조정 JSON을 유지하십시오. 노출, 그림자, 대비, 또는 온도를 인코딩하기 위해 .cube LUT를 생성하지 마십시오. 사용자가 LUT를 제공하거나 선택한 처리가 명시적으로 LUT를 소유하는 경우에만 LUT를 사용하십시오. resolve --type grade --for ... --analyze는 측정 증거일 뿐, 선택한 처리를 생성된 LUT로 대체할 권한이 아닙니다. 지원되는 비네트, 그레인, 블러, 픽셀화, 색상 또는 처리 효과를 CSS/SVG 오버레이로 다시 만들지 마십시오. 이는 Studio 컨트롤과 표준 미리보기/렌더링 셰이더 경로를 우회합니다.

선제적 대응 — 미디어 기회 점검 실행

인간은 일반적으로 어떤 미디어가 작품을 향상시킬지 알 수 없습니다. 당신은 알 수 있습니다. 구성을 만들거나 검토할 때, 하나의 근거 있는 스캔을 수행한 후 한 번만 물어보십시오. — 자동으로 추가하지 말고, 에셋별로 잔소리하지 마십시오.

구체적인 신호가 있을 때만 기회를 표면화하십시오:

감지된 신호제안
화면상의 텍스트 / 음성 해설이 없는 스크립트TTS 음성 해설 (오디오 엔진)
이모지 또는 아이콘처럼 스타일링된 <div>실제 icon 검색
플레이스홀더, 작거나 업스케일된 것처럼 보이는 이미지더 나은 image (및/또는 업스케일 — references/operations.md 참조)
소리가 없는 하드 씬 컷 / 전환전환 sfx
약 10초 이상인 조각에 음악 배경 없음bgm
노출 부족/과다 또는 색상 캐스트로 읽히는 영상보정 등급 (hyperframes media-treatment --selector '#hero' --analyze --json으로 검사)
시각적으로 평평하거나 주제에서 벗어난 사진 미디어하나의 특정 소스에 적합한 프리셋 또는 커스텀 처리, 의도된 대상 이름 지정
정적으로 느껴지는 의미 있는 미디어 진입/공개하나의 지원되는 seek-safe 처리 애니메이션; 요청이 프리셋을 정당화하지 않는 한 색상 유지

이것을 도움으로 유지하고 잔소리로 만들지 않는 규칙: 근거 있음, 일반적이지 않음 (신호 없음 → 제안 없음); 의견 있고 구체적임 (기본값이 선택된 특정 수정 제안 — 인간이 전체 / 일부 / 없음 승인); 프로젝트당 한 번 (하나의 통합 요청; "그대로 둬" 존중); 표면화, 절대 자동으로 변형하지 않음 (컬러 그레이딩 특히: 제안 및 미리보기 — 회색 세계 "보정"은 의도적인 일몰 또는 네온 룩을 망칩니다).

찾아야 할 곳 — 작업에 필요한 파일만 읽기

작업읽을 파일
검색 / 재사용 / 채택 / 수집, 플래그, 캐스케이드, 인벤토리references/resolve.md
컬러 그레이딩, LUT, 스마트 그레이드 (--for), 그레이드 비교references/grading.md
음성 해설 / TTS, 음악, SFX, 자막, 전사 (오디오 엔진)references/audio.md
기존 미디어 자르기 / 리프레임 / 변환, 정확한 오류 확산, HEVCreferences/operations.md
소스 인식 크리에이티브 처리, 실시간 효과, 오버레이, 공개references/media-treatments.md
설치 + 인증, 공급자 테이블, RAM 사다리, --local-only, --providerreferences/setup-providers.md
기억된 환경설정 + 동결된 레시피 (사용자 메모리)references/memory.md
소유권 매트릭스, 사용 통계, 텔레메트리, 개인정보 보호 (유지보수자 대상)references/meta.md

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

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.

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

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.

관련 스킬