Communitygithub.com

HyperFrames 创意设计

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

HyperFrames 创意设计 是什么?

HyperFrames 创意设计技能专注于 HyperFrames 视频项目中非动画部分的创意指导。该技能的核心职责包括:处理设计规范文件(如 frame.md 和 design.md)、管理调色板与排版选择、规划旁白和节拍、设计音频响应式视觉效果以及制定构图模式。它适用于品牌和风格相关的决策,确保视频在视觉上具有一致性和吸引力。该技能提供了详尽的参考文献,如 `house-style.md` 和 `video-composition.md`,这些文档对于避免生成模板化的网页风格输出至关重要。用户可以通过路线图快速查找所需资源,包括调色板、字体、讲故事结构和数据可视化等。该技能还包含多个脚本工具,用于生成对比报告、提取音频数据等。需要特别注意的是,该技能严格限制在非动画领域,所有与动画相关的原子运动和场景蓝图都应通过 `hyperframes-animation` 技能处理。

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

在你喜欢的 AI 中提问

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

文档

HyperFrames 创意设计 是做什么的?

品牌、节奏、风格、旁白和构图指导。在 hyperframes-core 的技术契约就位后使用。

对于运动模式、场景蓝图、过渡和 CSS 标记效果,请使用 hyperframes-animation —— 本技能有意排除了动画。

对于任何非平凡的构图,请首先阅读以下两项 —— 它们会覆盖网页本能:

  • references/house-style.md —— “解释提示,生成真实内容”、懒人默认列表以及背景/前景图层配方。这将字面重绘转化为一个_概念_。
  • references/video-composition.md —— 视频介质的尺度、景深和前景细节。它解释了如何避免空白的网页页面布局,而不强加通用的元素数量。

跳过这两项是导致输出千篇一律、形似网页页面的最大原因。对于超出单行编辑的任何任务,在您选择颜色或编写 HTML 之前,请务必打开这两个文件。它们在下面的路由表中不是可选项。

工作流程

  1. 如果项目有设计规范,请先阅读它,并将其 frontmatter 令牌视为品牌真理(颜色、字体、间距、语调、约束)。要读取哪个文件(优先级 frame.md → design.md → DESIGN.md)以及如何解析它(frontmatter = 规范性,散文 = 上下文)在 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

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.

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.

相关技能