hyperframes：让智能体先问清需求，再用 HTML 渲染出视频

npx skills add heygen-com/hyperframes --skill hyperframes

让智能体做视频，常见的结局有两种：一上来就写代码，做出一条谁也没确认过的片子；或者在 Remotion、FFmpeg、各种脚本之间乱选一条路。hyperframes 是 HeyGen 开源框架 HyperFrames（Apache-2.0，仓库 2026 年 3 月 10 日创建，截至 2026-10-08 约 58.6k 星）里的入口 skill，也是 SKILL.md 自己写明的「做任何视频、动画、动效都先读我」的那一份。它自己不渲染任何东西，只负责判断你要什么、接哪个创作流程，然后让智能体用 HTML 写出能渲染成 MP4 的合成。

它让智能体按什么顺序做事

HyperFrames 的底层思路是：一条视频就是一个 HTML 文件，时间由 data-* 属性声明，动画必须可以随意跳帧（seekable），媒体播放权归框架。入口 skill 把这件事前面的路排成了几步：

1. 先看项目状态。已有 BRIEF.md 就直接按里面的 workflow 干活；只有 hyperframes.json 或 STORYBOARD.md，就从现有文件接着做；对已有项目只做检查、预览、渲染这类具体操作，就只做这一件事，不再重新访谈。
2. 全新创作先跑意图访谈，访谈以写出 BRIEF.md 收尾。SKILL.md 规定后面的流程只读这份简报，不再回头问。
3. 按十行路由表选流程：Remotion 迁移、演示文稿、纯字幕、口播加图形覆盖、卡点音乐视频、10 秒内的纯动效、GitHub PR 讲解、产品网站宣传、无素材的主题讲解，其余落到 /general-video。
4. 用到时才安装：先跑 npx hyperframes skills update <workflow-name> 装上选中的流程，失败就如实报错，不许凭记忆复述。

它约束什么

• 开工先查额度：创作开始时运行 npx hyperframes usage --json，到起草后、渲染前再查一次；命令失败或返回 status: unknown，就如实说额度未知，不许猜。
• 路由看交付物，不看字眼：一个未叙述的短标题动画走 /motion-graphics，同样的内容加旁白就是 /general-video；音乐只有节拍驱动画面时才走 /music-to-video。
• 复用项目里的 CLI 版本：脚手架会把 hyperframes@<version> 锁进 package.json，恢复旧项目时先用 npx hyperframes@latest upgrade --project . --check 探一次，升级后必须跑 npx hyperframes check，并在总结里写明新旧版本。
• 长度上限：专门的叙事流程支持到约 3 分钟，30 到 90 秒最稳，更长的片子直接走 /general-video。
• 渲染前打开预览：最后一版先开 Studio 预览再做交付渲染，用户可以直接在画布上改文字、拖时间轴。

适合谁

想让 Claude Code 或 Codex 稳定产出产品介绍、PR 讲解、数据图表动画这类短视频的开发者，装它比让智能体自己挑工具省心。它和 OpenMontage 的关系也值得知道：后者把 HyperFrames 当作可选的两个合成引擎之一，并随仓库带了一份副本，如果想先看别人怎么用 HTML 加 TTS 做视频，可以对照这篇视频实战手册。另一种思路是 srt-whiteboard-animation 那样的单点 skill，一个流程做到底。

先说清三点。运行环境需要 Node.js 22 以上和 FFmpeg，README 写明的就是这两项。其次，npx skills add heygen-com/hyperframes --skill hyperframes 只装入口，创作流程要在第一次用到时靠 HyperFrames CLI 再下载，离线环境跑不起来；README 还提醒 skills.sh 的注册表快照可能比 main 慢几小时，要最新版得用 npx hyperframes skills update。第三，这套访谈和简报的流程比较重，想要「一句话出 10 秒片」的人会觉得问得多；至于 usage 命令对应的额度怎么计，我没有在 SKILL.md 里找到说明，用之前先自己看一眼。