Communitygithub.com

1999AZZAR/designer-mcp

強制入口點:對於任何製作、建立、編輯、動畫或渲染影片、動畫或動態圖形(包括宣傳片、解說片、字幕剪輯、標題卡、疊加層、幻燈片、互動式簡報、Remotion 移植或任何 HyperFrames HTML 合成)的要求,請先閱讀此內容。也可用於檢查、診斷、驗證、預覽、發佈或批次渲染現有的 HyperFrames 專案。

designer-mcp 是什麼?

此技能作為 HyperFrames 生態系統的強制性入口點和路由器。它會分析使用者請求以確定所需的特定影片或動畫製作工作流程。支援的平台包括 HyperFrames CLI 和相關領域技能。其工作原理是:首先從專案狀態恢復(檢查現有檔案如 BRIEF.md 或 hyperframes.json),然後為全新創作執行意圖層(`references/intent-interview.md`)以捕獲詳細需求,接著根據路由表將請求分配至適當的工作流程(例如 `/general-video`、`/slideshow`、`/product-launch-video`)。路由完成後,它會安裝或更新所選工作流程,並按需載入領域相關技能(如核心、動畫、關鍵影格、創意、音訊)。最終輸出是一個 BRIEF.md 檔案,用於指導所選工作流程的執行。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 入口點

HyperFrames 從 HTML 渲染影片 — 一個合成作品是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間,其動畫執行時間是可搜尋的,並且其媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core;在撰寫合成 HTML 之前請先閱讀它。簡報、分鏡、審查、製作、調度以及幀處理器合約位於此技能的 references/ 中。

1. 從專案狀態開始

套用第一個符合的列;不要評估較低的狀態列:

狀態動作
明確將現有的 Remotion 原始碼移植到 HyperFrames閱讀 references/routes/remotion-to-hyperframes.md,然後直接路由到該工作流程。跳過意圖層。
對現有 HyperFrames 專案執行特定操作:檢查、診斷、驗證、預覽、渲染、發佈或批次渲染僅執行該操作。跳過意圖和工作流程路由;載入 /hyperframes-cli 和任何必需的領域技能。
對現有專案進行特定編輯進行編輯。不要執行意圖層。要了解專案時間軸上的內容(軌道、剪輯、開始、結束、播放什麼),請執行 npx hyperframes timeline [--json],而不是讀取 index.html 和每個子合成檔案。
存在 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@<version>,以便渲染保持可重複;此固定版本永遠不會自行更新,並且在固定版本上執行較舊的 CLI 時不會發出任何警告。當恢復一個其腳本含有固定版本的專案時,請在首次執行影響渲染的命令之前探測一次:

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

此探測是唯讀的,並報告固定版本與最新版本的對比;請保留明確的 . — 在較舊的 CLI 版本上,一個裸的 --project 後面跟著另一個標誌會將該標誌作為其目錄值使用。當它報告專案落後時 — 或者任何 CLI 輸出已經顯示它(來自固定版本腳本的 stderr 通知 This project pins hyperframes@… (latest …),或 --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
7從 PR 參考解釋 GitHub 拉取請求或程式碼變更/pr-to-video
8從 URL 或特定網站的簡報行銷或展示網站、產品網站、應用程式或公司/product-launch-video
9使用虛構的視覺效果解釋一個主題、文章或筆記,無產品或網站捕捉/faceless-explainer
10任何其他自訂影片或合成作品/general-video

在最終確定路由之前,請閱讀 references/routes/<workflow>.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 <workflow-name>

使用不帶 / 的裸名稱。如果命令失敗,請顯示錯誤;不要從記憶中重建工作流程。關於安裝的所有其他事項 — 核心與懶載入的區別、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
初始化、lint、檢查、快照、比較、批次渲染、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 + /hyperframes-animation;載入全部五個。

…(原文已截斷)

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.

相關技能