Communitygithub.com

1999AZZAR/designer-mcp

处理 HyperFrames 合成中的推进/拉出、缩放、重新构图、Ken Burns 效果、摄像机运动、视觉匹配/扫画过渡及其他安全可寻帧的 2D/3D 关键帧;也用于 GSAP、CSS 关键帧、Anime.js、WAAPI、FLIP、路径、蒙版、SVG 变形/绘制、文字轨迹、3D 景深或 `hyperframes keyframes` 诊断。

designer-mcp 是什么?

该技能专注于 HyperFrames 生态中的关键帧系统,用于定义和验证视觉运动的姿态合约。它支持 GSAP、CSS 关键帧、Anime.js、WAAPI 和 FLIP 等多种动画机制,能够处理推进/拉出、缩放、Ken Burns 效果、摄像机移动、匹配剪辑、遮罩过渡等常见创作者需求。其核心原则是:关键帧只负责视觉运动,不干预时间线剪切或拼接(由 `/hyperframes-core` 管理)。技能提供了详细的步骤、合约和运行时规则,确保运动安全可寻帧、可验证,并可通过 `hyperframes lint`、`hyperframes check` 和 `hyperframes keyframes` 等 CLI 工具进行诊断。它不支持自动面部追踪、语义重构或任意源中冻结等自动行为,所有几何和物理效果需手动编写。该技能适用于 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-keyframes

在你喜欢的 AI 中提问

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

文档

HyperFrames 关键帧

关键帧是一种姿态合约:可见状态、连续主体身份、安全可寻帧运行时、经过验证的像素。

使用 hyperframes-animation 处理广泛的场景配方。使用 hyperframes-cli 获取完整的命令文档。仅在实现机制而非视觉风格不明确时,才使用 references/keyframe-patterns.md。

创作者编辑边界

关键帧拥有视觉运动,而非片段组装。源范围硬切、修剪、拼接和重新排序属于 /hyperframes-core:每个保留范围创作一个媒体元素,使用 data-start 和 data-duration 放置,并使用 data-media-start 选择其源偏移。相邻范围构成硬切。交叉淡变使用不同轨道上的重叠片段加上视觉不透明度关键帧;声音淡变使用 /hyperframes-audio。

创作者请求真实的机制
推进/拉出在片段内部的非计时视觉/裁剪包装器上,使用带有 x/y 或百分比平移的关键帧 scale。使用 set/短 tween 实现硬推进,使用 tween 实现平滑移动。
平滑多状态缩放或重新构图保持一个主题包装器存活,并将多个缩放/重新构图状态编写为每个段具有独立缓动的姿态阶梯。
平移、重新构图或 Ken Burns 摄像机移动动画化包装器平移加缩放。几何是手动编写的;这不是面部追踪或自动语义重构。
链式摄像机移动在一个已注册的安全可寻帧时间线上,链式标注变换节拍。
匹配剪辑或扫画/hyperframes-animation 拥有视觉交接;/hyperframes-registry 提供原语;关键帧保留已编写的几何、方向和速度。没有自动的匹配帧发现。
裁剪和蒙版重构在内部视觉包装器上插值 clip-path 或蒙版,以裁剪/重构而不改变源时间。多边形关键帧可形成多边形/蒙版过渡。
定向划变或虹膜/揭示划变在重叠的视觉片段上动画化蒙版/裁剪边界;/hyperframes-animation 拥有交接编排。
分屏交接保持两个视觉片段由核心放置,然后关键帧化其内部裁剪/蒙版包装器和分隔线几何。
恒定源重定时/hyperframes-core 拥有标准化的 data-playback-rate (0.1..10),用于渲染安全的画面和保持音调的声音。它对整个媒体元素保持恒定。
源速度渐变<video>/<audio> 上 data-automation 中的 rate 通道(t 以片段秒为单位,v 0.1..10,对数插值);它覆盖恒定速率。
冻结/保持视觉姿态、源最后一帧或完成的子合成可以保持。不支持任意源中冻结;预处理一个静止/派生的片段,将其作为自己的片段放置,然后用另一个源范围恢复。

同时编辑画面和声音时,加载 /hyperframes-core(用于片段和时间线)、本技能(用于视觉运动)以及 /hyperframes-audio(用于已放置轨道上的淡变、交叉淡变、音量自动化、闪避/雕刻、效果)。

视觉过渡或裁剪处理不是时间上的源修剪或拼接。/hyperframes-core 拥有时间线、片段时序和源范围;关键帧仅动画化这些片段内部包装器上的可见交接或裁剪。对于可复制的画面/声音组合配方,使用 /hyperframes-core → references/creator-editing-recipes.md。

流程

  1. 标识动画主体、可见状态、最终状态和运行时。
  2. 选择能证明提示的最小机制。仅在机制不明确时阅读 references/keyframe-patterns.md。
  3. 在声明的运行时内编写安全可寻帧的关键帧。同步构建并注册运行时实例。
  4. 使用 hyperframes lint、hyperframes check、hyperframes keyframes、一个聚焦的 --shot 以及在证明时刻的截图进行验证。
  5. 如果证明失败,修复源关键帧并在渲染前重新运行最小的失败诊断。

合约

  • 命名移动的主体。
  • 命名证明预期运动所需的姿态,包括最终状态。
  • 仅对可见通道关键帧化,而非隐藏的辅助状态。
  • 当连续性重要时保持对象标识。
  • 仅在预期运动是替换或溶解时使用交叉淡变。
  • 将可读或语义状态保持足够长时间以被看到。
  • 最终帧是动画的一部分,而非清理。
  • 除非请求,否则不要重置为静止状态。
  • 除非请求,否则不要以黑屏结束。
  • 如果编辑起始场景,除非要求重新设计,否则保留布局、文案、资源、颜色和最终状态。

运行时规则

GSAP:

  • 在页面加载时同步构建
  • 使用 gsap.timeline({ paused: true })
  • 注册为 window.__timelines[compositionId]
  • 注册键必须匹配 data-composition-id
  • 对于渲染关键的运动,不要调用 tl.play()
  • 保持循环次数有限

CSS 关键帧:

  • 有限持续时间和迭代次数
  • 确定性延迟
  • animation-fill-mode: both
  • 当时序属于某个片段时使用 data-start

Anime.js:

  • 同步创建
  • autoplay: false
  • 有限持续时间和循环
  • 将每个实例推入 window.__hfAnime

WAAPI:

  • 有限 duration
  • fill: "both"
  • 确定性构造
  • 文本表面不列出 WAAPI;使用 --shot(它可寻帧 WAAPI)和截图进行验证

永远不要用于渲染关键的运动:

  • Date.now()
  • performance.now()
  • 未播种的 Math.random()
  • 悬停/滚动触发器
  • 定时器
  • 异步创建的时间线
  • 未注册的 requestAnimationFrame
  • 无限循环

GSAP 骨架

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

对语义状态使用标签。使用位置参数而非链式延迟。对后续接触同一属性的 from()/fromTo() tween 使用 immediateRender: false。

关键帧形式

  • 数组关键帧:每步带持续时间和缓动的姿态阶梯。
  • 百分比关键帧:单个 tween 内的精确时序。
  • 属性数组:紧凑的多停止变化。
  • 当每个停止携带自己的缓动时,父级使用 ease: "none"。
  • 当每个段应共享相同感觉时使用 easeEach。

不要从示例中复制数值距离或时序。从实际合成几何和持续时间中推导它们。

对于一个在两框之间移动的主体,首选一个连续的变换 tween 或 FLIP。仅当观看者应感受到不同节拍时才将 x/y/scale 拆分为多个带缓动的关键帧;每个段都会改变速度,可能被解读为磕绊。

通道

推荐合成器/视觉通道:x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、蒙版、CSS 变量、SVG 路径/虚线值、摄像机变换、着色器统一变量。

避免布局/生命周期通道:top/left/right/bottom、width/height、margin/padding、display、visibility、后期 DOM 创建、执行主体运动的辅助覆盖层。

对于可见性变化,在已注册的可寻帧 GSAP 时间线上使用 autoAlpha,或在显式边界处使用零持续时间的 tl.set()。仅作用于非裁剪元素或片段内部的包装器;永远不要作用于 .clip 本身。永远不要对原始 visibility 进行持续时间 tween,也永远不要对 display 进行 tween。

机制选择

选择能证明提示的最小机制:

需求机制
同一主体改变框或层次结构共享元素 / FLIP
主体沿可见路径移动路径移动
描边增长或描边描边绘制
形状变为另一个形状形状插值
揭示边界可见裁剪、蒙版或着色器统一变量
许多项目按顺序移动交错 / 索引延迟
文本本身移动行、词、字符或子带划分
表面弯曲、拉伸或裁剪父/子反向变换
UI 有状态显式状态机
场景有景深DOM 3D、Three.js 或 WebGL 摄像机/对象关键帧

机制可以组合,但每种都必须阐明想法。装饰不是证明。

时序

  • 预期仅当它阐明原因或方向时使用。
  • 加速离开静止状态。
  • 峰值证明明确无误地显示机制。
  • 跟随动作传达能量和方向。
  • 仅当主体应感觉有弹性或触感时使用超调。
  • 恒定速度路径移动通常需要 ease: "none"。
  • 离散 UI 状态通常需要锐利的缓出。
  • 重复元素需要有序偏移,而非相同时序。
  • 最终锁定需要比过渡姿态更长的保持。
  • 平滑意味着同一主体上连续的 velocity。
  • 不要重叠写入同一变换属性的 tween,除非重叠是有意且经过验证的。
  • 避免在同一英雄表面也在缩放或移动时动画化大的 clip-path/蒙版变化;在主移动稳定后使用嵌套揭示。

文字

保留行框、词间距、可读性和最终适配。如果文字内部移动,移动字形或遮罩带,而不仅仅是文字周围的装饰。对可读帧进行截图。

SVG

对于描边增长,首选 DrawSVGPlugin,然后是 stroke-dasharray/stroke-dashoffset。对于形状插值,首选 MorphSVGPlugin;必要时将基本体转换为路径,并将复杂轮廓拆分为更简单的部分。

3D

单独的缩放是虚假的深度。在稳定父级上使用透视,transform-style: preserve-3d、z 移动、旋转、摄像机/世界运动、遮挡以及对象交错时的层顺序。

使用一个或两个能暴露深度关系的诊断角度。如果倾斜证明未显示深度交错,改进 z/摄像机/遮挡。

Canvas / WebGL

通过确定性状态关键帧化摄像机位置、摄像机目标、对象变换、材质不透明度、着色器统一变量和后处理强度。从 HyperFrames 时间渲染。使用 --ghost,因为标记框无法看到内部画布运动。

CLI 证明

npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

为真实动画主体选择 <selector>。为第一帧、证明姿态、最终保持前和精确最终选择 <times>。仅当必须证明景深时选择 <angle>。

工具证明内容
keyframes目标、显式停止、路径、轨迹、组合的父/子运动、CSS 停止、Anime 注册
--shot鬼影、路径形状、时间间距、DOM 3D 投影、聚焦选择器证明
--layout strip原地运动、重叠、接触、微妙缩放/不透明度、文字波浪
--ghostcanvas、WebGL、着色器运动、渲染的 3D
snapshot --at蒙版、文字可读性、完整状态、最终锁定、黑屏/重置尾部

如果选择器证明看起来错误:

  1. 重新运行 --json
  2. 找到实际的动画目标
  3. 拍摄该目标
  4. 截取完整帧
  5. 信任绘制的像素而非日志

诊断阅读

flat 表示没有显式中姿态。keyframes 表示存在显式停止。m

…

[内容已截断]

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

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.

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.

相关技能