用途：oil-motion 用于把交互意图转化为可验证的动画资产、时间线清单和网页运行时，适合需要由用户输入驱动视频或图像序列的网页动效场景。
主要能力：区分两类工作。AI 生成负责语义层面的变化，例如角色转身、产品爆炸成零件、镜头飞越场景；确定性代码负责输入映射、播放控制、媒体处理与性能优化。支持滚动、指针、拖拽、触摸、设备方向、音频、数据等输入源。还可对绿幕视频与精灵图进行清理、抠像、帧插值与压缩。流程以四份单一事实源（概念契约、动效简报、时间线、动效预算）保持一致性。
使用方式：确认是否已安装，全局检查 ~/.agents/skills/oil-motion/SKILL.md，项目检查 .agents/skills/oil-motion/SKILL.md；已安装则以 oil-motion 调用。未安装时检测范围后安装：全局执行 npx skills add oil-oil/oil-motion --skill oil-motion -g -y；项目执行 npx skills add oil-oil/oil-motion --skill oil-motion -y。在 Claude Code 中可用以 ! 开头的聊天消息运行命令。安装后触发短语包括“oil motion”“scroll-driven video animation”“sprite sequence web animation”“pointer-driven video”。
依赖与限制：需 Python 3.10+、Pillow、ffmpeg 与 ffprobe，技能会在使用时让代理执行 pip install -r scripts/requirements.txt。仅 AI 关键帧与视频生成需要 ZenMux API Key，按生成计费，提示词、参考图与关键帧会发送给 ZenMux 及其背后的模型提供方；本地处理已有媒体无需密钥。密钥录入设置页需 Node.js 22.18+，上游称目前仅在 macOS 验证。许可为 MIT。
不适用场景：纯 CSS、JS、SVG 或 Lottie 可实现的过渡与微交互应改用 css-animation-skill、gsap-skills 或 framer-motion-skills；实时 3D 场景应使用 cloudai-threejs；独立视频剪辑或合成应使用 remotion 或 hyperframes。