Communitygithub.com

1999AZZAR/designer-mcp

HyperFrames 專案的媒體作業系統,單一技能涵蓋所有媒體需求:解析、生成、操作與記憶。

designer-mcp 是什麼?

這是一個專為 HyperFrames 專案設計的媒體代理技能,核心概念是「單一技能,零上下文噪音」。它將所有媒體操作統一為一個 `resolve` 指令,可處理背景音樂 (BGM)、音效 (SFX)、圖片、圖示、品牌 Logo、語音、色彩校正 (grade) 及 LUT 等類型。當目錄中找不到所需資源時,它會自動透過 TTS、音樂或圖片模型生成。技能支援 HeyGen CLI 及本地模型 (如 Kokoro),並提供完整的音訊引擎進行語音旁白、轉錄、字幕及去背。除了媒體解析,它還能主動掃描專案中的機會(如為無旁白的腳本添加語音、為場景轉換添加音效),並以一次性的、具體的建議形式提供,而非持續干擾。此外,對於視覺反饋(如畫面太暗、平淡、需要復古風格),它會引用「媒體處理 (Media Treatments)」來應用色彩校正、預設效果或即時濾鏡,並遵循從評估、提案到持久化的漸進式工作流程。此技能支援 Claude Code、Cline 等工具,並透過 Markdown 文件 (SKILL.md) 提供詳細的參考指南。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/media-use

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

media-use

HyperFrames 的媒體作業系統:resolve · generate · operate · remember — 所有媒體類型,單一技能,零上下文噪音。

首次執行:安裝並登入 heygen CLI(免費使用路徑),然後使用 npx hyperframes media-use resolve --doctor 驗證。設定與提供者:references/setup-providers.md。

Resolve — 唯一的動詞

npx hyperframes media-use resolve --type <type> --intent "<描述>" --project <目錄>

回傳一行結果:resolved <id> → <路徑> (<類型>, <metadata>)。所有搜尋噪音都留在硬碟上。

類型一行描述
bgm背景音樂(HeyGen 目錄,超過 10,000 首曲目)
sfx音效(內建 19 個檔案庫 + 目錄)
image照片、背景(HeyGen 資產搜尋,超過 75,000 個向量素材)
icon圖示、符號(透明背景)
logo官方品牌標誌(theSVG → GitHub 頭像 → favicon;絕不重繪)
voiceTTS 語音旁白(HeyGen 免費使用路徑;可選本地 Kokoro)
grade量化的校正候選;廣泛的潤色/風格化處理請參閱「媒體處理」
lut使用者提供或明確選擇的可重複使用已驗證 .cube 檔案

在重新解析新素材之前,使用 --candidates 列出可重複使用的候選項,然後自行判斷其適用性——重複使用規則、所有旗標、導入(--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 語音旁白(音訊引擎)
Emoji 或一個被設定為圖示樣式的 <div>解析真正的 icon
圖片是佔位符、解析度低或看起來有放大痕跡一張更好的 image(及/或放大——請參閱 references/operations.md)
生硬的場景切換 / 沒有音效的轉場過場 sfx
一段超過約 10 秒且無背景音樂的片段bgm
看起來曝光不足/過曝或有色偏的鏡頭一個校正性的 grade(使用 hyperframes media-treatment --selector '#hero' --analyze --json 檢查它)
看起來視覺上平淡或離題的照片媒體一個具體的、來源合適的預設或自訂處理方案,並指明預期的目標
一個有意義的媒體進場/揭曉,但感覺靜態不動一個受支援的、安全無跳幀的處理動畫;保留顏色,除非該請求也證明了預設的合理性

讓這項功能成為助力而非干擾的規則:基於具體信號,而非泛泛而談(沒有信號 → 不建議);有主見且具體(提出具體的修正方案並附上預設選擇——由人類批准 全部 / 部分 / 無);每個專案一次(一次性整合請求;尊重「保持不變」);提出方案,絕不默默修改(特別是色彩處理:提出預覽——一個灰階世界的「校正」會毀掉刻意為之的日落或霓虹燈效果)。

到哪裡查閱——只需閱讀任務所需的文件

任務查閱
resolve / reuse / adopt / ingest、旗標、級聯、庫存清單references/resolve.md
色彩校正、LUT、智慧 grade(--for)、grade 比較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.

相關技能