1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | motion-prompt |
| 作者/维护者 | showheyohtaki(Shohei Ohtaki,个人开发者;另有 3 位外部贡献者提交翻译 PR) |
| 来源链接 | https://github.com/showheyohtaki/motion-prompt |
| 许可证 | MIT |
| GitHub Stars / Forks | 552 / 64(GitHub API,2026-10-21 读取) |
| 最新版本 | 暂无 Release / Tag;主分支近日持续提交(最近一次 2026-10-20) |
| 安装方式 | npx skills add showheyohtaki/motion-prompt |
项目自述名称为 Motion Prompt。
2. 功能介绍与亮点
Motion Prompt 是一套「给动效起名字」的编号库:把人们让 AI 做的东西(动态图形、运镜与转场、UI 组件、落地页特效、照片光影)拆成 144 个带编号的名字,每个附动态样例、一句话含义、提问示范,以及一段可直接移植的 Canvas 2D 绘制函数。
- 看图选名字:
pick命令在本机浏览器打开图库,用户点选想要的效果并附一句备注,选择结果回传给 AI;不必先知道「这个动作叫什么」。 - 按需检索与取码:
search(中日英关键词)、list、get <编号>、kit <套组>、prompt <编号>,每次只取用到的几个,避免整库灌入上下文。 - 按项目技术移植:附
references/porting.md,说明如何把同一个效果改写成 Remotion、CSS/SVG/Lottie、After Effects 表达式,或写成 Veo、Seedance、Sora 等视频模型的文字提示。 - 纯函数、可循环:每个效果是时间
u的纯函数,无随机、无状态,实时播放与逐帧渲染一致,在周期末尾无缝循环。 - 多语言:名称表为英文、日文,外部贡献者已补入简体中文、繁体中文、西班牙文。
3. 适用场景
分类:前端与设计。
适合用 Remotion、Canvas、CSS 或视频生成模型做短视频、产品演示、落地页动效的开发者与创作者,尤其是「想要某种效果但说不出名字」的人。不适合需要完整动画编排或成片剪辑的场合:库只覆盖单个动作,镜头之间如何衔接仍要自己设计。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库含 .claude-plugin 清单,README 以 npx skills add 安装 |
| Codex | 原生支持 | README 明确写出 Claude Code 或 Codex 安装后即可使用;CLI 为 Node 脚本,沙箱无网络时需放行该命令访问 github.io |
| OpenClaw | 未验证 | 仓库未声明 |
| Hermes Agent | 未验证 | 仓库未声明;SKILL.md 与脚本为通用格式 |
5. 推荐理由
做动效最难的常常不是实现,而是描述。这个库把模糊需求变成「编号加名字加可运行样例」,让用户看图点选、AI 按编号取码移植,减少来回猜测。每个效果带固定时长与缓动参数,移植后与演示保持一致;脚本只读公开文本数据,没有账号与密钥要求。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 建仓约一周获 552 stars、64 forks;有外部贡献者提交的真实 PR;暂无第三方媒体或具名用户评价 |
| 可用性 | 8 | 一条命令安装;文档完整(SKILL.md、porting 指南、FORMAT、贡献指南),含图库与 CLI;需 Node.js 与可联网(无 Node 时有纯 HTTP 取数的替代说明);近日每天有提交 |
| 安全性 | 7 | 见下方检查清单 |
综合 = 三项均值 = 7.0。
安全检查清单:
- Shell 命令:CLI 仅用
child_process.spawn打开本机浏览器;缓存写入本地目录,未见拼接用户输入的 shell。✅ - 联网外发:只从
showheyohtaki.github.io与raw.githubusercontent.com下载公开目录文本;pick仅监听 127.0.0.1,需带随机令牌的单次 GET,不向外发送数据。✅ - 凭据:不需要任何 API key。✅
- 可疑指令:SKILL.md 与 CLI 通读,未发现隐蔽指令、混淆代码或夹带推广;SKILL.md 要求移植的代码必须来自本次会话
get的输出,不得凭名称臆造。✅ - 作者信誉:个人开发者(教育与餐饮行业创业者),账号 2018 年创建;仓库较新。⚠️
- License:MIT,各效果文件头带归属行;含 THIRD-PARTY-NOTICES。✅
- 维护时间:近日仍在提交。✅
- 注意:效果代码在运行时由远端目录下发,使用前应审阅再并入自己的项目。⚠️
7. 跟同类 Skills 相比的优势
| 类型 | 典型做法 | 与 Motion Prompt 的差异 |
|---|---|---|
| 单一框架动画 skill(Remotion、GSAP 等) | 讲解某个框架的动画写法 | 绑定一种技术栈;Motion Prompt 以效果为中心,可移植到多种技术或写成视频模型提示 |
| 动效设计规范类 skill | 给出缓动、时长等原则 | 偏原则;Motion Prompt 提供编号化、可运行的具体样例 |
| 通用图库或素材站 | 人工浏览与复制 | 没有 agent 取码接口;Motion Prompt 的 pick、get 让 AI 直接按编号取用 |
核心差异:先让用户「看着选」,再让 AI「按编号取」,并且效果与技术栈解耦。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。仓库 Issue 区有外部贡献者的实质提交,例如 #1 简体中文支持(xhonye)、#2 西班牙文(herberthcr)、#3 繁体中文(daddydanielt),均为补充语言包(来源:https://github.com/showheyohtaki/motion-prompt/issues)。
9. 其他补充
- 目前 6 个套组、共 144 个编号:motion、camera、ui、lp、photo、motion2,每组 24 个。
- 提供
make-your-own/说明与提示,可制作自己领域或语言的同类名称库。 - 设有「使用示例」页,收录他人用这些名字做出的作品。
10. 安装使用方式
npx skills add showheyohtaki/motion-prompt
安装后对 AI 说「打开 motion-prompt 图库」即可触发 pick;已知编号时直接说「用 #012 和 #045」。
命令行直接使用:
node <skill目录>/scripts/motion-prompt.mjs search typewriter text
node <skill目录>/scripts/motion-prompt.mjs get 12
11. 注意事项
- 需要 Node.js 和网络;沙箱环境默认无网络时,需为该命令放行。
- 库只覆盖单个动作,整支视频的节奏与镜头衔接需自行设计。
- 效果均为 Canvas 2D 样例,
photo套组更适合作为图像模型的文字提示,不建议直接移植代码。 - 项目建仓时间短,暂无正式版本号,套组与编号可能继续增加。
- 移植时需保留各效果文件头的 MIT 归属行。