Communitygithub.com

1999AZZAR/designer-mcp

必先读取此技能:处理任何视频、动画或动态图形的创建、编辑、渲染请求的入口点。用于检查、诊断、验证、预览、发布或批量渲染现有的 HyperFrames 项目。

designer-mcp 是什么?

这是 HyperFrames 框架的强制性入口技能,用于处理所有与视频、动画和动态图形相关的请求,包括宣传片、解说视频、带字幕的剪辑、标题卡、叠加层、幻灯片、交互式演示、Remotion 移植或任何 HyperFrames HTML 合成。它也用于检查、诊断、验证、预览、发布或批量渲染现有的 HyperFrames 项目。输入可以是网站 URL、GitHub PR、Figma 设计或 URL、文本或简报、现有素材或音乐。该技能通过读取项目状态(如 `BRIEF.md`、`hyperframes.json` 或 `STORYBOARD.md`)来恢复工作,捕获用户意图(如果适用),根据交付物类型选择合适的专属工作流(如 `/general-video`、`/slideshow`、`/motion-graphics`),并按需加载领域技能(如 `/hyperframes-core`、`/hyperframes-animation`、`/hyperframes-audio`)。默认输出框架为 HyperFrames,除非用户明确选择其他框架或仅录制浏览器会话。该技能支持 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 中提问

打开一个已预加载此 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@<版本> 以保持渲染可重现;固定版本不会自动更新,并且运行较旧 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
初始化、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断/hyperframes-cli
注册表块和组件/hyperframes-registry
命名的外观、效果、处理或过渡 —— CRT 扫描线、故障、胶片颗粒、闪光扫过、五彩纸屑爆发 —— 在手动构建之前/hyperframes-registry
Figma 资产、令牌、组件或作为重构动画的故事板帧/figma

创作者编辑短语是跨领域请求。加载匹配行中命名的所有技能:

创作者请求必需领域
“剪辑此素材”、硬切、修剪、拼接、重新排序或使用源范围/general-video + /hyperframes-core;核心拥有 data-start、data-duration、data-media-start 和轨道布局。
在此处放大、推近/拉远、平滑多状态缩放或重新构图、肯·伯恩斯或摄像机运动/general-video + /hyperframes-core + /hyperframes-keyframes;动画内部视觉/裁剪包装器,而不是定时剪辑。
匹配剪辑或甩镜头摄像机转场/general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry;在手动创作之前搜索/安装转场基元。
淡入、淡出、轨道增益/音量、自动化、闪避/雕刻、音频效果,或跨多个轨道的效果/general-video + /hyperframes-core + /hyperframes-audio;核心放置剪辑,音频混音放置轨道 —— 包括跨越一组轨道的子混音总线。
将画面和声音编辑与摄像机运动或混音相结合的编辑

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.

相关技能