
Motion Video Director 是一项制作技能,可将编程代理转变为动态设计师、视频编辑、导演和声音设计师。它可以通过代码制作动画解说视频,编辑口播视频素材,准备配音文稿,同步音效,并以竖屏、宽屏或方形格式渲染最终 MP4 视频。
该项目结合 SKILL.md 中的制作指南和辅助脚本使用。代理不会立即渲染完整视频,而是针对脚本、计划和预览设置审核环节。
Motion Video Director 的功能
这项技能同时支持完全生成的动态图形,以及基于现有素材的剪辑。动画可以使用 Canvas、SVG、Three.js 或 GSAP 编写;视频素材项目则可以结合剪辑、快速缩放、字幕、B-roll,以及置于主体后方的文字。
- 动态图形: 创建动态排版、UI 模拟图、光标动画、贴纸、粒子、Lottie 元素和 3D 场景。
- 视频素材剪辑: 通过剪辑、字幕、快速缩放、变速和主体抠像编辑口播视频片段。
- 配音规划: 制作适用于 ElevenLabs 的文稿,并根据逐词时间安排镜头。
- 声音设计: 添加与画面帧同步的渐强音、冲击音和呼啸音,降低配音下方的声音音量,并达到目标平台响度。
- 本地渲染: 使用代码、无头 Chrome 和 ffmpeg,以 9:16、16:9 或 1:1 格式导出 MP4 视频。
安装此技能
选项 1:快速安装
推荐使用 npx skills 命令安装。请在项目文件夹中运行:
npx skills add Miftahul-Islam-Efaz/Motion-graphics-skill
你需要先安装 Node.js。安装程序会询问你使用的代理,并将技能复制到相应位置。此方法支持 Claude Code、Codex、Cursor 以及其他支持技能的代理。
选项 2:Claude Code 插件
在 Claude Code 中,添加市场条目并安装插件:
/plugin marketplace add Miftahul-Islam-Efaz/Motion-graphics-skill
/plugin install motion-video-director@motion-graphics-skill
安装完成后重启 Claude Code。
选项 3:手动安装
- 使用代码和下载 ZIP下载仓库,然后解压。
- 将
skills/motion-video-director文件夹复制到~/.claude/skills/,以便在所有项目中使用。 - 或者,将其复制到项目中的
.claude/skills/,仅在该项目中启用。 - 重启 Claude Code。
在 Windows 上,全局 Claude Code 技能目录通常为 C:\Users\<you>\.claude\skills\。对于 Codex、Cursor 或其他兼容代理,请将该文件夹复制到项目中,并提供以下指令:
Read skills/motion-video-director/SKILL.md and follow it for this video project.
检查环境
Motion Video Director 需要 Node.js 18 或更高版本、ffmpeg、ffprobe,以及配备无头 Chrome 的 Playwright。可选的 Python 工具可以增加转录、主体抠像和音轨分离功能。
- 必需: Node.js 18+、ffmpeg、ffprobe,以及配备无头 Chrome 的 Playwright。
- 可选: Python 3.10+,以及
faster-whisper、rembg和demucs。 - 可选集成: ElevenLabs、Firecrawl、Freesound、Pexels、Pixabay 和 LottieFiles 的 API 密钥或 MCP 服务器。
运行预检脚本,查看已安装和缺失的依赖:
bash skills/motion-video-director/scripts/preflight.sh
API 密钥存储在本地 .env 文件中,该文件已从 git 中排除。仓库还提供了 create_env.sh,用于创建包含空密钥字段的环境文件;以及 normalize_env.py,用于将现有密钥文件转换为干净的 .env。
创建你的第一个视频
安装技能后,用自然语言描述你想要的视频。有视觉参考时,请一并附上。例如:
为我的 SaaS 制作一条 30 秒的 9:16 发布短片。参考资料已附上。
你也可以要求基于现有视频素材进行剪辑:
将我的原始口播片段剪辑成一条带字幕、快速缩放和 B-roll 的短片。
对于以产品为核心的项目,请提供目标风格和时长:
制作一条 45 秒的产品解说视频,介绍我们的仪表板。采用简洁的 UI 动画和细腻的声音设计。
遵循制作流程
代理采用分阶段流程,让你可以在最终渲染前审核重要决策。
- 简报: 代理收集参考资料、故事、目标受众、格式和时长。
- 配音文稿: 编写可直接粘贴到 ElevenLabs 的文稿。你生成 MP3 后将其发回。
- 分镜: 每个镜头都根据配音中的词语进行计时。
- 制作: 使用代码制作动画场景,并编辑提供的视频素材。
- 预览: 项目为每个场景渲染联系表,以便在完整渲染前发现问题。
- 渲染与混音: 导出包含声音设计并完成响度标准化的最终视频,然后执行质量检查清单。
你可以在最终渲染前审批脚本、计划和预览。工作流会将进度记录在 PROGRESS.md 中,让新会话能够从上一次停止的位置继续。
探索主要制作功能
导演与节奏
该操作手册涵盖前三秒的吸引点、节奏、镜头类型、J 剪辑、L 剪辑、匹配剪辑以及行动号召结构。它还定义了五个剪辑强度等级,从快节奏短视频到克制的企业宣传片。
动画与动态图形
对于生成式视觉内容,该技能支持动态排版、3D 文字、UI 模拟图、光标动画、贴纸、粒子、Lottie 内容和 Three.js 产品镜头。它还应用缓动、交错和过冲等动画原理。
素材与主体处理
对于拍摄素材,该工作流可以使用 RVM 和 SAM2 等工具添加冲击缩放、字幕、变速和主体抠像。根据剪辑需要,字幕也可以放置在主体后方。
色彩、布局与无障碍
指南包含 60-30-10 配色法、WCAG 对比度要求以及适用于 9:16 平台的安全区域。这些注意事项有助于确保重要文字和视觉元素在平台原生格式中保持清晰可读。
配音与声音
配音脚本可为 ElevenLabs 准备,而 faster-whisper 可以提供单词时间戳。声音设计可以加入与单帧同步的渐强、冲击音和呼啸声,在人声下方进行闪避处理,目标混音为 -14 LUFS 和 -1.5 dBTP。
使用辅助脚本
仓库包含多个支持制作工作流的脚本:
preflight.sh检查 Node.js、ffmpeg、Playwright、Python 工具和 API 密钥。preview.mjs将选定时间范围渲染为联系表,以便快速审核。analyze_ref.sh将参考视频拆分为帧、剪辑片段和音频。create_env.sh创建带有空 API 密钥字段的.env文件。normalize_env.py将现有密钥文件转换为整洁的.env。
获得更佳结果的高级技巧
- 尽早提供参考:附上视觉示例,让简介和分镜符合预期风格。
- 明确交付格式:说明视频应采用 9:16、16:9 还是 1:1,并注明所需时长。
- 分阶段审核:利用脚本、分镜和联系表预览审批关卡,在完整渲染前发现问题。
- 整理源素材:清楚标识视频、音频、Logo、字体和其他参考资料,以便智能体准确整合。
- 适时使用可选工具:使用
faster-whisper进行转录,使用rembg进行抠像,使用demucs进行分轨。 - 构建前检查环境:先运行预检脚本,避免在项目后期才发现缺少渲染依赖。
- 根据进度日志继续:在新会话中恢复工作时,查阅
PROGRESS.md。
结语
Motion Video Director 为使用 Claude Code、Codex、Cursor 或其他支持终端的编码智能体制作完整视频提供了结构化方法。安装该技能,描述项目,审核脚本和分镜,检查预览,然后让本地渲染工作流生成最终视频。它同时支持代码生成的动态图形和剪辑后期素材,无需使用 After Effects 或 Premiere Pro。
