跳转到使用指南
motion-graphics作者 HeyGen

Motion Graphics Skill.

一个用于动态和视频的 Claude Code 和 Codex skill:短时设计驱动的动态图形:动态文字、数据计数动画、标志演绎、字幕条。

  • Motion & Video
  • Video
heygen-com/hyperframes · skills/motion-graphics/SKILL.mdSKILL.md
--- name: motion-graphics description: A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up … --- ## Categories — split by the search decision ## Prerequisites ## Flow ## Resume table ## Design notes (maintainers — execution does not read this)
从上游文件读取的前置内容和章节标题,2026-09-14 · 完整内容共 15,566 字符

01 功能说明

motion-graphics skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

一个以路由为先的 skill,用于制作一段简短、以设计为主导、无旁白的动态图形——动态排版、数字滚动统计、图表命中、Logo 冲击动画、下标字幕、动态地图、推文或网页——时长通常在 10 秒以内,最长不超过约 30 秒,渲染为 MP4 或带透明通道的叠加层。

它以素材为先、以复用为先:第一个分支点在于该作品是否需要搜索——表单类别基于用户提供的内容运行,asset_needs 为空;搜索驱动的类别则依据返回的内容类型进行动画处理;Builder 会先组合目录中的模块,再手工编写空缺部分。工作流是自主的,最多提出一个澄清问题,但渲染始终需要用户确认,需先通过 lint、检查和校样快照。

它产出什么

  • 先草稿再定稿的 shot-plan.json,保存 envelope、所选类别或搜索意图、asset_needs,以及 block、layout、motion 和 positions。
  • compositions/index.html,遵循 HF 契约,在 window.__timelines 上有一个暂停的 GSAP timeline,具备 clip 类和稳定的 id,以及确定性的 tl.seek(0)。
  • snapshots/ 目录下的联系表或快照表,用于检查校样时间点。
  • renders/video.mp4,或在使用 webm 或 mov 格式渲染时输出带透明通道的叠加层。
查看示例提示词 ↗

工作方式

  1. 01
    初始化项目

    步骤 0 会创建 PROJECT_DIR = videos/<project-name>/,并使用空白示例和该 skill 运行 hyperframes init;当 hyperframes.json 已存在时会完全跳过此步骤。

  2. 02
    规划并决定是否搜索

    第一个分支点在于该作品是否需要搜索:否则为表单类别,asset_needs: [];是则将搜索查询写入 asset_needs[]。

  3. 03
    在需要时获取素材

    步骤 2 通过 media-use 将素材解析为冻结的项目本地路径及一份台账;当 asset_needs 为空时,直接跳过此步骤进入设计阶段。

  4. 04
    围绕已有素材进行设计

    第二次 Director 处理会围绕已解析的素材选取目录 block 和 hyperframes-animation 规则与 blueprint,然后完成 shot plan 的最终定稿。

  5. 05
    以复用为先进行组合

    Builder 使用 npx hyperframes add 添加目录 block 并就地定制,仅手工编写空缺部分和素材融合功能点,生成 compositions/index.html。

  6. 06
    拍摄校样快照

    选择能展示开场状态、标志性动作和最终定格的校样时间点,然后检查生成的联系表或快照表。

02 找到适合场景

何时使用 motion-graphics Skill

在 Claude Code 或 Codex 中,当任务是此类运动与视频时,使用 motion-graphics skill。以下适用范围和限制取自 skill 自己的文件。

适合场景

  • 一句有力的台词、引言或标题,文字运动本身就是全部创意所在。
  • 带有数字滚动动效和环形图的单一主视觉数字。
  • 基于用户自有 logo 制作的 logo 动效或品牌锁定组合。
  • 地理运动效果,例如高亮区域、连接地点或缩放至某个位置。
  • 当搜索提供来源内容时,制作动态推文、新闻文章或标题排版效果。

了解边界

  • 更长、带旁白或多场景的作品会走其他路径。
  • 任何带旁白或真人实拍主体的内容,或超出短片时长范围的内容。
  • 依赖搜索的类别在服务商不可用时会失去已找到的素材,从而回退到无素材模式。
  • 通过原始 MCP 工具驱动 Figma 会跳过消毒处理、来源追溯和品牌 token 绑定,因此该路径被排除。

需要提供的信息

  • 内容本身动态文字、统计数据、图表、logo 展示和下方字幕条都使用用户提供的内容,因此文案、数字、数据或 logo 来自你,而非搜索。
  • 一个 figma.com URL(如果素材就在那里)先运行 /figma 进行素材导出、品牌 token 提取以及 Motion 到 GSAP 的转换,然后基于其输出结果构建。
  • 用于素材获取的可选密钥GEMINI_API_KEY 或 GOOGLE_API_KEY 用于图像生成,此外 asset_scout 和搜索服务商用于网页、新闻、推文以及 asset-fusion 真实素材搜索。

03 Skill 内部

motion-graphics skill 为 Claude Code 和 Codex 设定的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 通过 /hyperframes 进行路由

    入口是 /hyperframes;这个 skill 只制作短小、以设计为主导、无旁白的动态图形,通常时长在 10 秒以内,没有配音,也没有真人实拍主体。

  2. 先问一个问题,再开始构建

    该工作流按设计是自主运行的:最多从 agents/director.md 提出一个澄清问题,随后一路构建到验证完成,中途没有评审环节。

  3. 刷新 skill 前先确认

    在运行更新命令前先询问用户;如果已是最新版本,该命令会快速空转,否则会刷新此 skill 以及它所依赖的核心领域 skill。

  4. 渲染由用户把关

    检查和验证快照通过后,先询问是标准预览还是渲染,只有在明确得到渲染的答复后才进行渲染。

  5. 切勿在工作区根目录初始化

    切勿在工作区根目录运行 hyperframes init,也不要在 PROJECT_DIR 内嵌套另一个 hyperframes/ 目录。

  6. 每个命令都在子 shell 中执行

    无论由主流程还是子 agent 发出,每条 Bash 命令都以 (cd "$PROJECT_DIR" && ...) 子 shell 形式执行;不允许使用裸 cd。

  7. 推导项目名称

    使用用户给出的目录,否则从意图中生成一个简短的 kebab-case 名称,形如 <subject>-motion;不要使用工作区的基础名或时间戳。

  8. 不要用时长来掩盖缺陷

    当某个 gate 失败时,切勿仅为掩盖缺陷而更改固定时长;应就地修复合成内容。

04 投入使用

在 Claude Code 或 Codex 中安装 motion-graphics

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 motion-graphics 添加到 Claude Code、Codex 或您的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/heygen-com/hyperframes --skill motion-graphics

针对 skills/motion-graphics/SKILL.md 的通用 skills CLI 形式;仓库可能记录了其自身的路径。

给 Skill 一个首次动效和视频任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Make a short motion graphic, about 8 seconds, from [our launch tagline] — kinetic type, motion-first, no narration, using the kinetic-type category and the caption blocks. Then close with a logo sting built from [our logo.svg], and render it to MP4.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 在进行任何其他操作之前,先运行 lint 并对项目进行 check;两者都作为子 shell 从 PROJECT_DIR 运行。
  • 在继续之前,检查生成的 contact 表或 snapshot 表。
  • 当 lint、check 或 snapshot 失败时,派发修复子 Agent 进行一次就地修复,然后重新运行失败的 gate。
  • 确认渲染输出存在、非空且具有预期时长,并确认交接说明中标明了产物、时长、帧 id 和验证时间点。

在 OpenDesign 中,从其 SKILL.md 链接导入 motion-graphics:Plugins → Add → Skill → Import from link,然后在顶栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
HeyGen
Repository
github.com/heygen-com/hyperframes 分支 main
Skill 文件
skills/motion-graphics/SKILL.md 内容校验和在验证时记录;提交 558c11b
License
Apache-2.0 来自 LICENSE。
仓库星标数
49,761 GitHub 快照拍摄于 2026-09-14,针对整个 heygen-com/hyperframes 仓库,该仓库在此目录中包含 9 个 skills。这不是 motion-graphics 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. motion-graphics — 派发入口说明了入口点、自主流程、项目目录,以及从初始化到渲染的阶段表。
  2. 类别 — 按搜索决策划分列出无需搜索的表单类别,以及由返回内容决定的、依赖搜索的类别。
  3. 前置条件平台、系统工具、macOS GPU 环境变量、可选的 API key 及其本地回退方案。
  4. 流程步骤 0 至 6:初始化、规划、取材、设计、构建、验证、批准、渲染。
  5. 续接表针对每种部分完成的项目状态,说明应从哪一步继续。
  6. 设计说明(维护者专用 — 执行阶段不会读取此内容)以资产优先为原则、复用优先的映射关系、类别模块契约、目录结构以及路由注册。
Skill 自身的描述
「一个简短的、以设计为主导的动态图形,动效即信息——动态文字排版、数据递增统计、图表/数据可视化展示、logo 闪现/品牌标识、下三分之一字幕/标注/社交媒体叠层、动态地图(高亮区域、连接地点、缩放到某位置)、动态推文/新闻文章/标题、网页/UI 动画(滚动、光标、标注),或将真实图像的几何结构融入图表。通常不超过 10 秒(最多约 30 秒),无旁白或真人出镜;渲染为 MP4 或透明叠层。更长/带旁白/多场景 → /general-video。不确定 → /hyperframes。」

SKILL.md 文件的前言描述。完整文件约 15,566 个字符。在 GitHub 上阅读完整文件。

Motion Graphics

在真实的动效与视频任务上运行 motion-graphics。

下载 OpenDesign,从其 SKILL.md 链接导入 motion-graphics,粘贴上述提示词,在看到结果前先阅读计划。

终端
npx skills add https://github.com/heygen-com/hyperframes --skill motion-graphics

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows