Codex Skill 安装：三种方式装好你的第一个 Skill

案例库里后面的 17 个案例，很多都要先装好一个 Skill 才能开始。这一节是案例库的第 00 课：先把「怎么安装 Skill」这件事彻底跑通，后面的案例就能直接上手。

适用场景

• 你在网上看到一个想用的 Skill（通常是一个 GitHub 仓库），想把它装进 Codex。
• 你想搞清楚 Skill 到底装到了哪里，项目级和用户级有什么区别。
• 装完之后，你想确认 Codex 真的能识别并调用它，而不是「装了但没生效」。

安装前准备

• 已安装并能正常登录 Codex，桌面 App 或 CLI 均可。还没装好的，先回到 学习路线。
• 知道 Skill 的来源地址。一个标准 Skill 是一个包含 SKILL.md 的目录，概念和目录结构详见 Skills 和 Plugins。

本教程用一个社区 PPT Skill 做演示，你也可以换成任何你想装的 Skill：

guizang-ppt-skill

方式一：让 Codex 自己装（推荐新手）

Codex 内置了 skill-installer，可以直接把 Skill 仓库地址交给它，让它协助识别并完成安装。

例如：

请帮我安装这个 Skill：https://github.com/op7418/guizang-ppt-skill
安装完成后，告诉我它的用途、依赖要求，以及应该如何调用。

不同工作区里，安装方式可能不完全一样。有些会直接支持安装，有些则会先分析仓库结构，再提示你确认放置位置或依赖要求。skill-installer 默认安装到 ~/.codex/skills，安装后通常需要重启 Codex，新 Skill 才会出现在技能列表里。

方式二：手动放置目录

如果你想完全控制安装位置，或者不经过 Codex、自己管理 Skill 文件，可以手动把 Skill 目录放进 Codex 会扫描的位置：

范围	位置	适合场景
项目级	$REPO_ROOT/.agents/skills	团队共享，随仓库分发给所有人
用户级	$HOME/.agents/skills	个人常用 Skill，跨项目复用
用户级（Codex 传统位置）	$HOME/.codex/skills	skill-installer 的默认安装位置

以手动克隆为例：

git clone https://github.com/op7418/guizang-ppt-skill.git
cp -r guizang-ppt-skill ~/.agents/skills/

两种方式怎么选：.agents/skills 是 Agent Skills 开放标准推荐的通用发现位置，其他支持该标准的 Agent 工具也能识别，优先推荐；.codex/skills 只有 Codex 会读取。Codex 两类位置都会加载，效果等价。

方式三：社区一键安装工具

一些社区工具把「下载 + 放置」封装成了一条命令，例如 install-agent-skill（产业链瓶颈猎手 案例里用的就是它）：

npx install-agent-skill jojogh/industry-bottleneck-hunter

这类工具的安装目标目录可能和你的预期不同，装完后最好用下一节的方法确认 Skill 的实际落点和加载状态。

验证：确认 Skill 真的装上了

安装动作完成不代表 Codex 已经识别，建议按下面的顺序核对：

1. 重启 Codex。新安装的 Skill 通常要重启后才会被扫描进技能列表。
2. 在输入框敲 / 打开 Skills 菜单，确认新 Skill 出现在列表里。

3. 显式调用一次：在提示词里写 $skill-name，或从 Skills 菜单里点选它，让 Codex 跑一个小任务。
4. 也可以直接描述任务，看 Codex 是否会根据 Skill 的 description 隐式匹配到它。

如果列表里看不到，先检查目录层级是否多套了一层（正确结构是 skills/<skill-name>/SKILL.md），再确认 SKILL.md 里的 name 和父目录名一致。

你要重点检查什么

• 装的是不是你指定的那个 Skill，而不是名称相似的别的仓库。
• 安装位置是项目级还是用户级：写进仓库 .agents/skills 的 Skill，团队其他人拉代码后也能用。
• 有没有额外依赖：有些 Skill 还会依赖脚本、模板或本地环境，不是放好目录就能跑。
• 重名问题：多个同名 Skill 不会自动合并，必要时给 Skill 加团队或项目前缀（如 acme-doc-review）。

风险提醒

• 第三方 Skill 不是官方能力，质量和维护状态差异很大。安装前先读它的 SKILL.md 和附带脚本，确认不会执行你不期望的命令。
• 不要把密钥、token、私有凭据写进 Skill；来源不明的 Skill 如果索要凭据，保持警惕。
• 涉及联网、写文件或调用外部系统的 Skill，先用一个小任务验证，确认行为符合预期后再用于正式产物。

下一步

• 用 Codex × PPT Skill 完整走一遍「安装 → 调用 → 验证」的闭环。
• 想理解 Skill 的结构、编写方法和渐进式加载原理，读 Skills 和 Plugins。
• 想找更多可安装的社区 Skill，可以从 产业链瓶颈猎手 这类案例的源仓库开始逛。