1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | oil-motion |
| 作者/维护者 | oil-oil（GitHub 组织，License 署名 Lin Zhihuang，2 位贡献者） |
| 来源链接 | https://github.com/oil-oil/oil-motion |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 1,899（GitHub API 获取，2026-08-19） |
| Forks | 145（GitHub API 获取） |
| 最新版本 | 无正式 Release/Tag，滚动发布，最近一次提交 2026-08-15（GitHub API 获取） |
| 安装方式 | 告诉 Agent「帮我安装这个 Skill」即可拉取安装；首次生成视频前需额外配置一次第三方视频生成 API Key |
2. 功能介绍与亮点
oil-motion 是一个把网页动画从“手写关键帧”变成“AI 生成+程序化控制”的 Skill。它接管一整条流水线：先按用户描述的意图生成并锁定动作的首尾关键画面，再用 AI 视频模型补全中间的连续动作，随后逐帧检查去除停顿、重复与闪帧，最后按页面实际展示尺寸压缩打包，并把动画进度绑定到滚动、鼠标、拖动、触摸或设备方向等交互输入上。
核心亮点：
- 关键帧先行：不直接生成整段视频，而是先锁定开始/中间/结束状态，避免模型在生成过程中“跑偏”（改变产品结构、角色比例等）。
- 程序与生成模型分工明确：确定性工作（探测、插帧、抠色、去溢色、稳定、编码、打包）交给程序处理，生成模型只负责画面与动作本身，保证结果可复现、可测量。
- 交互映射双路径：根据动画尺寸与访问模式自动在“Alpha WebP 雪碧图”与“全关键帧色键 MP4（WebGL 实时抠像）“两种交付格式间选择，兼顾体积与流畅度。
- 凭据处理规范：API Key 保存在项目目录之外的本机配置文件中，且脚本会在生成日志中自动屏蔽远程 URL，避免密钥或敏感链接泄漏进项目、提示词或日志。
- 维护活跃：最近一次提交为 2026-08-15，仓库同时提供中英文文档与操作演示视频。
3. 适用场景
所属分类：前端与设计
适合需要为产品官网、角色/宠物互动、数据变化演示或章节转场制作响应式动画，但自己不具备 AI 视频生成与 WebGL 实时合成经验的前端开发者与独立开发者。典型场景包括：页面下滚时产品逐步展开或切换状态、鼠标移动时角色自然转向、拖动进度条驱动动画前进后退、移动端通过触摸或设备方向控制画面、组件状态变化时播放对应动作。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 采用标准 Agent Skills 规范（YAML front matter + 指令正文），且已被第三方 Claude Skill 目录站收录展示。
- Codex：✅ 原生支持。SKILL.md 正文明确以
$HOME/.codex/skills/oil-motion作为技能安装路径示例。 - OpenClaw：❓ 未验证。仓库未提及该平台，安装说明为“告诉 Agent 帮我安装”的通用表述，理论上可行但未找到直接证据。
- Hermes Agent：❓ 未验证。同上，无直接证据。
5. 推荐理由
网页交互动画长期存在一个断层：AI 视频生成模型只能“从头播到尾”，无法直接响应滚动、鼠标等用户输入。oil-motion 把这个断层补上了——用 AI 负责画面与动作的创意与连贯性，用确定性程序负责把生成结果转成可被交互实时控制的网页资源。对于想做出“苹果官网级”响应式动画、但既不懂视频生成工作流也不懂 WebGL 抠像的前端开发者，这个 Skill 相当于把一整套专业动画管线打包成了一句话需求。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 1,899 stars、145 forks，个人/小团队出品；自 2026-08-07 创建以来 12 天内保持持续增长，暂无多平台独立讨论 |
| 可用性 | 8 | 中英文文档完整，附操作演示视频，最近一次提交距今 4 天；需要本机 Python3/Pillow/ffmpeg 及第三方视频生成 API Key |
| 安全性 | 8 | 唯一联网目标为 zenmux.ai 视频生成 API，用途透明；API Key 存储在项目目录外且日志自动脱敏远程 URL；MIT 许可证明确；无可疑指令 |
安全检查清单：① 执行 shell/Python 脚本处理媒体文件，权限范围限于本地媒体处理与调用视频生成 API，可解释 ② 联网仅指向 zenmux.ai 一个目标，用途为上传参考图/下载生成视频，透明 ③ 要求配置视频生成 API Key，通过本机独立配置文件存储、不写入项目或日志 ④ 未发现可疑指令或夹带无关推广内容 ⑤ 作者为独立开发团队，无造假迹象 ⑥ MIT 许可证清晰 ⑦ 最近提交 4 天前，维护活跃
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 oil-motion 的差异 |
|---|---|---|
| scroll-world | 一次对话生成无剪辑滚动运镜 3D 着陆页 | 专注“一次性生成完整落地页”，产出是成品页面；oil-motion 产出的是可复用动画资源，交互方式覆盖滚动/鼠标/拖动/触摸/设备方向等更多输入源 |
| optimize-web-animations | 把动画性能与内存泄漏排查变成可复现工作流 | 解决的是“已有动画卡顿/内存泄漏”的排查问题，不负责生成新动画；oil-motion 是从零生成动画资源的创作工具，二者互补而非竞争 |
| Motion.dev 动画类 Skill（如 motion-dev-animations-skill） | 基于 Motion.dev 库封装 spring 物理、手势交互等前端动画代码模式 | 提供的是代码层面的动画实现范式，动作素材仍需人工设计；oil-motion 用 AI 视频生成动作本身，更适合需要复杂、非几何规律动作（如角色、产品拆解）的场景 |
8. 用户评价
在 GitHub Issues 中找到一条已验证的具体反馈：用户 HaocongDesign 实际使用该 Skill 后反馈，浏览器纹理尺寸上限（4096px）限制了单张雪碧图能容纳的关键帧数量，希望了解如何实现演示视频中 16×14 帧的大网格效果（来源：GitHub Issue #2，https://github.com/oil-oil/oil-motion/issues/2）。这条反馈同时说明确有真实用户在生产环境中使用该 Skill 制作复杂动画。除此之外，该技能目前在 Reddit、Hacker News 等平台尚无独立讨论。
9. 其他补充
仓库同时维护 README.md（中文）与 README.en.md（英文）两个版本，文档同步更新；提供操作演示视频便于快速理解效果。
10. 安装使用方式
- 在 Claude Code / Codex 等支持 Agent Skills 规范的工具中，直接对 Agent 说“帮我安装
https://github.com/oil-oil/oil-motion这个 Skill”，由 Agent 完成拉取安装。 - 首次生成视频前，运行
python3 "$OIL_MOTION/scripts/oil_motion_config.py" status检查配置；未配置时按提示运行set子命令，在终端交互式输入 ZenMux API Key（输入内容不回显），密钥保存在本机~/.config/oil-motion/config.json。 - 确保本机已安装 Python 3、Pillow、numpy、ffmpeg、ffprobe；确定性媒体处理流水线依赖这些工具。
- 直接向 Agent 描述动画需求（例如“用 oil-motion 把这两张产品图做成随滚动展开的动画”），后续的关键帧生成、视频补全、压缩打包与前端接入均由 Agent 结合该 Skill 自动完成。
11. 注意事项
- 视频生成依赖第三方付费 API（ZenMux
minimax/minimax-h3），需自行承担生成成本；默认模型固定，仅在用户明确要求或该模型无法完成目标时才更换。 - 浏览器纹理尺寸存在硬性上限（约 4096px），单张雪碧图能容纳的关键帧数量有限，超大网格（如 16×14）需要额外处理方案，Skill 本身尚未内置解决方案。
- 未发布正式版本号，仓库处于持续滚动更新状态，升级前建议关注最新提交记录。
- OpenClaw、Hermes Agent 上的兼容性未经验证，使用前建议先做小范围测试。