如何在 Claude Code、Codex 或 Cursor 中安装 Skill

Q: Claude Code 的 Skill 放在哪里？

放在 ~/.claude/skills/ / 中，所有项目都能用；或者放在某个项目内的 .claude/skills/ / 中。文件夹保留 Skill 的名称，里面放着它的 SKILL.md。新开一个 Claude Code 会话，让它加载这个 Skill。

Q: Skill 能在 Codex、Cursor 和 Gemini CLI 中使用吗？

能。同一个文件夹在这几个 Agent 中都能用，只是位置不同：Codex 用 ~/.agents/skills/ /，Cursor 用项目内的 .cursor/skills/ /，Gemini CLI 用 ~/.gemini/skills/ /。

Skill 是一个文件夹，里面有给 Agent 看的 SKILL.md 说明文件，以及模板和脚本。安装一次之后，只要你的请求匹配，Agent 就会自动使用它。同一个文件夹在 Claude Code、Codex、Cursor 和 Gemini CLI 中都能用，区别只在于放在哪里。

文件夹位置均来自各 Agent 自己的文档，已于 2026 年 10 月 29 日核实。

Skill 是什么

Skill 遵循开放的 Agent Skills 格式。一个 Skill 就是一个以 Skill 名称命名的文件夹，里面有：

**SKILL.md：**说明文件。开头的简短信息写明 Skill 的 name，以及说明何时使用它的 description；Agent 读取 description 来判断请求是否匹配，匹配时再读其余部分。
**参考资料：**说明文件指向的较长笔记，只在需要时才读取。
**模板和脚本：**Agent 会复制或运行的文件，例如视频模板、需求说明文件或检查脚本。

不会在系统层面安装任何东西，也不会创建账号：Agent 读取这个文件夹，Skill 的命令在你的项目中运行。

最快的方式：让 Agent 帮你装

在任意 Skill 页面复制安装提示词，粘贴给你的 Agent：

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

Agent 会读取安装说明，然后运行一条命令：npx motion-skills install <slug>。第一次运行时，浏览器会打开一个页面：用 Google 登录，并确认终端中显示的验证码。如果是你还没买的付费 Skill，同一个页面就能购买，付完后安装会自动完成。之后 Agent 会做出第一个视频。（命令运行不了时，安装说明会改为在浏览器里下载。）

手动安装

在 Skill 页面下载 ZIP。
解压时保留文件夹名（<slug>/SKILL.md）：
- Claude Code：~/.claude/skills/<slug>/，或项目内的 .claude/skills/<slug>/
- Codex：~/.agents/skills/<slug>/
- **Cursor：**项目内的 .cursor/skills/<slug>/
- Gemini CLI：~/.gemini/skills/<slug>/
新开一个 Agent 会话，让它加载这个 Skill。

mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

电脑上需要准备什么

Node.js 22 或更新版本
FFmpeg（macOS 上运行 brew install ffmpeg）
Google Chrome（渲染器会以无头模式驱动它）

完整版 Skill 和免费的 Motion Director 运行在我们的开源引擎 motion-skills（mo）上，第一次渲染时会通过 npx 自动安装；动效模板用的是 HyperFrames CLI，同样会自动安装。不需要任何 API 密钥。

如何使用 Skill

用动效模板时，直接提需求就行，比如「做一张 9:16 的标题卡，文字是『更快发布，安心入睡』」。Agent 会复制模板、写好 brief.json、运行 hyperframes check、查看截取的静帧排查排版问题，然后渲染出 MP4 并告诉你文件位置。

用完整版 Skill 时，把素材交给 Agent，说清楚片子用在哪里。Skill 会先给你看三个方向的真实画面，写好节奏表和原创配乐，运行 mo 检查并审片，然后在你自己的 Chrome 里渲染出 MP4。

完整的分步教程和一支真实示例片，见如何用 Claude Code 做视频。Codex、Cursor 或 Gemini CLI 的用法，以及每个 Agent 读取的所有文件夹，见用 Codex、Cursor 或 Gemini CLI 做视频。

故障排查

**Agent 没有使用这个 Skill。**安装后开启一个新会话，Agent 会在会话开始时读取 Skill（在 Gemini CLI 中，/skills reload 可以就地完成）。然后再提一次要求，并点名这个 Skill：「use the changelog-video skill」。也检查一下文件夹：SKILL.md 必须直接放在 <slug>/ 里，而不是解压后多出来的下一层目录里。
**「FFmpeg not found」。**安装 FFmpeg（macOS 上运行 brew install ffmpeg），然后打开一个新终端，让它出现在 PATH 中。
**「Chrome not found」。**安装 Google Chrome，渲染器会以无头模式驱动它。完整版 Skill 会先用 mo doctor 替你检查这一项，动效模板则用 node kit/doctor.mjs。
**登录页面没有打开。**终端会打印出地址和验证码；自己打开这个地址，输入验证码即可。

常见问题

Claude Code 的 Skill 放在哪里？

放在 ~/.claude/skills/<slug>/ 中，所有项目都能用；或者放在某个项目内的 .claude/skills/<slug>/ 中。文件夹保留 Skill 的名称，里面放着它的 SKILL.md。新开一个 Claude Code 会话，让它加载这个 Skill。

SKILL.md 是什么？

一个给 Agent 看的说明文件，和模板、脚本一起放在 Skill 文件夹里。它的开头写明 Skill 的名称和使用时机；请求匹配时，Agent 就会读取它。

Skill 能在 Codex、Cursor 和 Gemini CLI 中使用吗？

能。同一个文件夹在这几个 Agent 中都能用，只是位置不同：Codex 用 ~/.agents/skills/<slug>/，Cursor 用项目内的 .cursor/skills/<slug>/，Gemini CLI 用 ~/.gemini/skills/<slug>/。

需要 API 密钥吗？

不需要。Skill 在你的电脑上借助 Node.js、FFmpeg 和 Chrome 运行，引擎会通过 npx 自行安装。唯一需要的登录是在本站用免费的 Google 账号登录，用于下载。