Communitygithub.com

Motion Director

当用户要求创建、修改或渲染短视频时使用——如解说视频、产品宣传或广告、软件演示、动态图形、标题卡片、动画图表或社交媒体片段。与用户确认风格(或基于用户提供的设计包、网站、截图、一句话描述),撰写动态脚本,构建HyperFrames合成,预览并修复,最后渲染为MP4。

Motion Director 是什么?

Motion Director 是一个用于AI代理(如Claude Code、Cursor、Codex)的工具技能,专注于从零开始创建或修改短视频。它通过HyperFrames引擎将HTML和GSAP动画渲染为MP4文件,支持从风格定义到最终渲染的完整工作流程。该技能首先帮助用户明确视频的用途、受众、时长和宽高比,然后通过与用户协作确定视觉风格(支持多种协作模式,从完全自主决策到逐帧故事板设计)。接着,它会编写动态脚本并构建HyperFrames合成文件,之后通过跨节拍快照进行预览和迭代修复,确保视觉精准。最后渲染MP4,并可选择使用ffmpeg从MP4生成优化的小尺寸GIF。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PilCAki/motion-director/tree/HEAD/plugins/motion-director/skills/make-video

在你喜欢的 AI 中提问

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

文档

Motion Director 是做什么的?

你导演并构建一段短视频。HyperFrames 将 HTML + GSAP 渲染为 MP4。你自己编写这个合成,以最适合该视频的方式。

工作流程

  1. 理解需求。 视频的用途、观众、时长、宽高比。仅询问请求中未明确的部分。

  2. 确定风格。 如果用户提供了风格(如设计包、网站、截图、一句话描述),则直接基于该风格工作,无需询问。否则,请询问用户希望参与的程度:

    • 你决定。
    • 简要描述。 用户提供一两句话,你补充剩余内容。
    • 主题设计师。 商定颜色、字体和形状;展示一两个样式帧供批准。
    • 故事板设计师。 为每个节拍展示示例帧;逐节拍商定大小、位置和运动。

    无论采用哪种方式,风格必须定义得足够明确,以便决定每一个视觉选择。用你觉得合适的任何形式记录下来。

  3. 编写动态脚本 到 motion-script.md(必需)。按时序编写节拍:屏幕上显示什么,如何移动,以及何时移动。格式由你决定。

  4. 构建 HyperFrames 合成。首先阅读 references/hyperframes-quirks.md。它列出了可能导致错误帧或渲染失败的事实。

  5. 预览、检查、修复。 在每一个节拍处截取快照,并与动态脚本和风格对比。检查每个元素的大小是否与视频观看尺寸一致:所有内容都可见且清晰,没有过大或过小。修复并重新截取直到正确。

  6. 渲染,然后从 MP4 中在你预览的时间点提取帧,并与预览结果对比。渲染的寻址方式与快照不同,因此两者可能不一致。

    如果用户需要 GIF(用于 README、聊天或任何视频无法自动播放的地方),使用 ffmpeg 的两遍调色板(palettegen,然后 paletteuse)从 MP4 生成,控制宽度和帧率以保持文件小巧,并且也要检查其中一帧。

  7. 交付 MP4 的路径(如果制作了 GIF 也提供),附上一段简短的说明,介绍你制作的内容以及任何假设。

相关技能