Communitygithub.com

1999AZZAR/designer-mcp

搜尋、安裝並將註冊表區塊與元件接入 HyperFrames 合成。在手工建立任何命名視覺效果之前使用——每當簡報、使用者或腳本中提到某個外觀、效果、處理或轉場,例如 CRT 掃描線、故障效果、色像差、顆粒感、閃光掃掠、圖表、程式碼或終端視窗、地圖或五彩紙屑爆發——因為約 400 個託管項目已涵蓋其中許多,且搜尋可在無安裝、無專案、無帳戶的情況下對所有項目進行排序。也可在執行 `hyperframes add` 或 `hyperframes catalog`、安裝單一項目或所有符合標籤的區塊、將安裝的項目接入 index.html 或處理 hyperframes.json 時使用。涵蓋探索、安裝位置、區塊子合成接線、元件片段合併,以及創作新的區塊或元件以向上游貢獻(構想 → 搭建 → 驗證 → PR)。

designer-mcp 是什麼?

1999AZZAR/designer-mcp 是一個 HyperFrames 登錄表技能,專為 AI 代理(例如 Claude Code、Cursor、Codex)設計,用於搜尋、安裝和接線可重複使用的區塊與元件。它支援透過 `hyperframes add <name>` 安裝,區塊是獨立的子合成(擁有自己的維度、持續時間和時間軸),透過 `data-composition-src` 包含在宿主合成中;元件是效果片段(無自身維度),直接貼入宿主合成的 HTML。該技能涵蓋發現(透過 `hyperframes catalog --query` 進行語意或詞彙搜尋)、安裝位置配置(在 `hyperframes.json` 中設定路徑)、區塊接線(使用 `data-composition-id`、`data-start`、`data-track-index` 等屬性)、元件接線(複製 HTML、CSS 和 JS 片段),以及創作新項目並透過 PR 貢獻。搜尋在本機進行,不發送資料;`--on-device` 模式提供語意排序,需一次性模型下載(33 MB)。當搜尋結果不符合需求時,技能提示使用 `npx hyperframes feedback --search-miss` 報告缺口,以提供需求訊號。支援平台包括 HyperFrames CLI 和任何可執行 shell 命令的環境。

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

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 登錄表

登錄表提供可透過 hyperframes add <name> 安裝的可重複使用區塊與元件。

  • 區塊 — 獨立的子合成(擁有自己的維度、持續時間、時間軸)。透過宿主合成中的 data-composition-src 引入。
  • 元件 — 效果片段(無自身維度)。直接貼入宿主合成的 HTML。

快速參考

hyperframes add data-chart              # 安裝一個區塊
hyperframes add grain-overlay           # 安裝一個元件
hyperframes add captions                # 安裝所有標記為 captions 的區塊
hyperframes add shimmer-sweep --dir .   # 指定特定專案目錄
hyperframes add data-chart --json       # 機器可讀輸出
hyperframes add data-chart --no-clipboard  # 跳過剪貼簿(CI/無頭模式)

安裝後,CLI 會顯示已寫入的檔案以及要貼入宿主合成的片段。該片段是一個起點——接線區塊時,你需要添加 data-composition-id(必須與區塊內部的合成 ID 相符)、data-start 和 data-track-index 屬性。

位置參數首先被解析為確切的項目名稱。如果沒有相符項目且該值是一個標籤,則命令會安裝所有具有該標籤的區塊。登錄表依賴項會在請求的項目之前安裝。hyperframes add 僅適用於區塊和元件;對於範例,請改用 hyperframes init <dir> --example <name>。

安裝位置

區塊預設安裝到 compositions/<name>.html。元件預設安裝到 compositions/components/<name>.html。

這些路徑可在 hyperframes.json 中配置:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

詳見 install-locations.md。

接線區塊

區塊是獨立的合成——透過宿主 index.html 中的 data-composition-src 引入:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

關鍵屬性:

  • data-composition-src — 區塊 HTML 檔案的路徑
  • data-composition-id — 必須與區塊的內部 ID 相符
  • data-start — 區塊在宿主時間軸中出現的時間(秒)
  • data-duration — 區塊播放的時長
  • data-width / data-height — 區塊畫布尺寸
  • data-track-index — 圖層排序(數值越大越靠前)

詳見 wiring-blocks.md。

接線元件

元件是片段——將其 HTML 貼入合成標記中,CSS 貼入樣式區塊,JS 貼入腳本(如果有的話):

  1. 讀取安裝的檔案(例如 compositions/components/grain-overlay.html)
  2. 將 HTML 元素複製到你的合成的 <div data-composition-id="..."> 中
  3. 將 <style> 區塊複製到你的合成的樣式中
  4. 將任何 <script> 內容複製到你的合成的腳本中(時間軸代碼之前)
  5. 如果元件暴露了 GSAP 時間軸整合(請參見片段中的註解區塊),將這些調用添加到你的時間軸中

詳見 wiring-components.md。

探索

使用 CLI 作為主要的探索介面。在瀏覽之前先根據意圖搜尋: 登錄表包含的項目多到無法用肉眼掃描,因此列出它們並根據名稱或標籤進行匹配是慢速路徑,並且當作者的用詞與你的不同時會失敗。

# 對整個目錄進行排序,針對節拍應做之事
npx hyperframes catalog --query "reveal a headline one line at a time"
npx hyperframes add caption-clip-wipe

搜尋在本機進行,不發送任何資料。預設情況下,它根據與項目名稱、標題和描述共享的詞彙進行排序,因此它只能找到重複你詞語的項目;--on-device 則根據意義進行排序,但需要一次性模型下載。使用 --json 時,信封會指明是哪個層次回答的,因此請檢查該資訊,而不是假設已進行排序。

無論影片使用何種語言,始終用英文查詢。 目錄是用英文編寫的,兩個層次都以這種方式索引(本機裝置模型也是僅限英文)。使用其他語言的查詢不會產生可搜尋的詞語,並且會返回空結果。在日本或中文專案中很容易出錯,在這種情況下,簡報、字幕和旁白都是該語言,查詢自然會跟隨:用英文描述 動作,然後用影片所需的任何語言編寫螢幕上的文字。如果查詢返回 No searchable words in query,這是規則問題,而不是缺少元件,也不值得提交缺口報告。

可安裝性在排序之後應用,而非之前:向量攜帶但此登錄表無法提供的名稱會從結果中刪除並計入 dropped,因此非零的 dropped 表示兩者是不同世代。請參見 /hyperframes-cli 了解離線層次、同意閘門以及如何刷新過期索引。

若要瀏覽或篩選而非搜尋:

npx hyperframes catalog
npx hyperframes catalog --type block
npx hyperframes catalog --type component
npx hyperframes catalog --type block --tag social
npx hyperframes catalog --json
npx hyperframes catalog --human-friendly

普通的表格和 --json 模式僅列出匹配項;使用 hyperframes add <name> 安裝選定的名稱。--human-friendly 會打開一個互動式選擇器並立即安裝選定的項目。在 CI 或代理工作流程中,建議使用 --json 後跟明確的 add。

報告目錄中缺少的內容

當搜尋結果出來後,其中沒有任何內容能滿足需求時,請在手工製作該動作之前說明:

npx hyperframes feedback --search-miss "<你執行的查詢>" --wanted "<你需要的動畫>" --tier on-device

catalog --query 會為你列印此行,並預先填寫好,而 --json 則將其作為 report_gap 攜帶——因此在你決定沒有任何內容適合時,它已經準備就緒。

每當結果中的任何內容都無法滿足工作需求時,請報告,無論是哪個層次。 不要等待本機裝置層次回答:它需要一個經同意的 33 MB 下載,因此代理運行時除非明確選擇加入,否則處於 words 層次,而依賴 on-device 會使幾乎所有報告都保持沉默。--tier 值會隨附,以便在閱讀這些報告時,詞彙缺失與意義缺失之間保持可區分性。描述你需要的效果,而不是你想像中的項目名稱:返回的是一個值得建構的動作列表,而一個命名了不存在項目的報告什麼也教不會。這是唯一一個將查詢發送到任何地方的路徑,這正是它作為一個單獨的故意命令而非搜尋自行執行的原因。它不攜帶任何評級,也永遠不會進入評級指標。

這是整個目錄的需求訊號。跳過它意味著你遇到的缺口只能從安裝計數中推測,而安裝計數無法看到一個任何人都無法安裝的動作。

如果 CLI 無法連接到配置的登錄表,請檢查原始清單作為後備:

curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

CLI 無法連接的登錄表不會清空探索的目錄:只要重新驗證失敗,之前擷取的清單會在 24 小時刷新視窗之外繼續提供服務,因此 catalog 和 catalog --query 仍然會對磁碟上的最後一個副本進行列出和排序。

add 仍然需要網路,即使是你昨天安裝的項目也是如此。 只有清單會被快取;項目的實際檔案在每次安裝時都會重新擷取。因此,離線時你可以搜尋,也可以查看項目的內容,但安裝會在檔案擷取時失敗。不要向使用者承諾離線安裝。

每個項目的 registry-item.json 包含:名稱、類型、標題、描述、標籤、尺寸(僅限區塊)、持續時間(僅限區塊)和檔案列表。

詳見 discovery.md 以了解按類型和標籤篩選的詳細資訊。

貢獻新的區塊或元件

要創作一個新的登錄表項目(字幕樣式、VFX 區塊、轉場、下三分之一或可重複使用的元件)並將其作為上游 PR 提交——而非安裝現有項目——請遵循 contributing.md 中的完整工作流程:構想 → 搭建 → 建構 → 驗證 → 預覽 → 提交。可複製貼上的入門範本(字幕 / VFX / 元件 / registry-item.json)位於 templates.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

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

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.

相關技能