Communitygithub.com

1999AZZAR/designer-mcp

面向 HyperFrames 视频的非动画类创意指导,处理设计规范(frame.md / design.md)、调色板、排版、旁白、节奏规划、音频反应式视觉、构图模式及品牌/风格决策。若需原子级运动模式和场景蓝图,请使用 `hyperframes-animation`。

designer-mcp 是什么?

该技能专为 HyperFrames 视频项目提供非动画类创意指导,聚焦设计规范(frame.md / design.md)的处理、调色板、排版、旁白、节奏规划、音频反应式视觉、构图模式以及品牌/风格决策。它适用于 `hyperframes-core` 技术合同已经确立后的阶段,强调执行前必须阅读 `references/house-style.md` 和 `references/video-composition.md` 以避免产生通用网页风格输出。技能支持多种工作流程:读取或创建设计规范、选用预置帧、规划场景节奏、以及音频反应式视觉等。其路由表清晰划分了不同主题资源(如调色板、构图模式、数据动画、排版、旁白等)的读取路径,并附带了对比度检查、音频数据提取等实用脚本。该技能与 `hyperframes-animation` 严格分工,后者专门负责动画模式与场景蓝图。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames Creative

品牌、节奏、风格、旁白与构图指导。在 hyperframes-core 的技术合同确立后使用。

对于运动模式、场景蓝图、过渡效果以及 CSS 标记效果,请使用 hyperframes-animation —— 本技能刻意不涉及动画。

对于任何非平凡的构图,请先阅读以下两篇文档 —— 它们将覆盖你的网页本能:

  • references/house-style.md —— “解读提示,生成真实内容”,惰性默认列表以及背景/前景图层配方。这将把字面的重新样式转变为一种_概念_。
  • references/video-composition.md —— 视频媒介的比例、景深和前景细节。它解释了如何避免空洞的网页布局,同时不强制设定一个统一的元素数量。

跳过这两篇文档是导致泛泛的、类似网页风格的输出的最主要原因。在下方的路由表中,它们不是可选的条目 —— 对于任何超过一行编辑的任务,在选取颜色或编写 HTML 之前,请先打开这两篇文档。

工作流程

  1. 如果项目包含设计规范,先阅读它,并将其 frontmatter 标记视为品牌事实(颜色、字体、间距、语调和约束)。读取哪个文件(优先级 frame.md → design.md → DESIGN.md)以及如何解析(frontmatter = 规范,prose = 上下文)已在 references/design-spec.md 中统一定义 —— 请按照该文档进行解析和加载。
  2. 如果没有设计规范且用户要求视觉方向,请选择一个路径:
    • 现成的帧预设(可选)→ frame-presets/(采用一个 FRAME.md 作为 frame.md;参见 references/design-spec.md)
    • 命名风格或调性 → references/visual-styles.md
    • 快速默认 → references/house-style.md
    • 交互式选择 → references/design-picker.md
  3. 对于多场景项目,在编写 HTML 之前规划节拍和节奏 → references/beat-direction.md。关于场景过渡,请跳转到 hyperframes-animation/transitions/。
  4. 对于运动密集型工作,请阅读 references/motion-principles.md(高级别的护栏),然后前往 hyperframes-animation 获取原子规则。

路由

主题读取文档
采用现成的帧预设作为 frame.md(可选)frame-presets/ · references/design-spec.md
默认调色板、运动、排版、需要质疑的惰性默认值references/house-style.md
命名风格预设、调性到风格的映射references/visual-styles.md
调色板特定的颜色标记palettes/*.md
构图模式 —— 画中画、文字后置主体、标题卡、幻灯片references/composition-patterns.md
统计/信息图展示references/data-in-motion.md
开放提示的结构化扩展references/prompt-expansion.md
视频媒介的密度、比例、颜色、帧构图references/video-composition.md
按节拍指导、节奏规划、过渡时序references/beat-direction.md
创作后的规范验证(颜色、字体、圆角、间距、景深)references/design-adherence.md
高级运动护栏和 GSAP 质量规则references/motion-principles.md
字体选择、配对、渲染视频的排版护栏references/typography.md
故事原则 —— 钩子语言、先价值后证据、故事板作为提案、溯源视觉素材references/story-spine.md
脚本节奏、语气、开场白、数字发音references/narration.md
预先计算的音频频段映射到运动references/audio-reactive.md

脚本

  • scripts/contrast-report.mjs —— 检查渲染帧中的对比度警告。
  • scripts/extract-audio-data.py —— 预先提取音频频段用于音频反应式构图。
  • scripts/package-loader.mjs —— 支持脚本,用于捆绑的创意工具集。

contrast-report.mjs 首先从当前项目解析辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅当在捆绑的 CLI/技能安装之外运行该技能,并且需要明确固定引导版本时,设置 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

从仓库根目录运行,使用显式路径,例如:

python skills/hyperframes-creative/scripts/extract-audio-data.py <音频文件>

动画分析 (animation-map.mjs) 位于 hyperframes-animation/scripts/。

边界

  • 不要覆盖 hyperframes-core 的技术规则。
  • 对于最小化的技术构图,不要要求设计系统。
  • 不要添加额外的场景、旁白、音乐、字幕或过渡效果,除非请求中有要求,或者你首先提出扩展方案。
  • 保持配方引用与任务相关;对于简单的编辑,不要阅读所有参考文档。

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

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.

相关技能