夜雨聆风最近很多 AI Agent 项目都开始提到一个词：
Skills。
但我发现身边很多人还不会安装，今天来讲讲 Skills 的各种安装方式，总有一款适合你。
简单说，Skill 就是一份给 AI Agent 看的操作说明书（当然不完全是）。
它通常是一个文件夹，里面至少有一个 SKILL.md。
有些 Skill 还会带脚本、模板、参考资料、配置文件。
比如：
• 让 Agent 按固定流程写文章 • 让 Agent 分析 PR 评论 • 让 Agent 调用某个云服务 • 让 Agent 搜索最近 30 天的社媒讨论 • 让 Agent 按团队规范生成代码 • 让 Agent 处理 Markdown 图片上传
以前你要把这些规则一遍遍告诉 AI。
现在可以把它做成一个 Skill，装到 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw 等工具里。
这篇文章只讲一个实际问题：
Skills 到底怎么安装？
常见安装方式
现在常见的安装方式，大概有这几类：
• 用 npx skills add安装• 手动复制或软链接到本地 Skills 目录 • 把 Skill 放进项目目录，跟代码一起提交 • 用 Claude Code 的插件市场安装 • 用 Codex 的 $skill-installer安装• 下载 .skill文件，在 claude.ai 网页端上传• 下载 .mcpb，装到 Claude Desktop• 用 OpenClaw 的 clawhub install安装• 做成 Plugin，再通过 Marketplace 分发
不同工具支持的方式不完全一样。
但底层逻辑差不多：
把一组 Skill 文件放到某个 Agent 能扫描到的位置。
方式一：npx skills add
现在很多开源 Skill 项目，都会给一个类似命令：
npx skills add google/skills或者：
npx skills add mvanhorn/last30days-skill -g这是目前很常见的一种通用安装方式。
比如 Google 官方的 google/skills 仓库，README 里给的安装命令就是：
npx skills add google/skills项目地址：
https://github.com/google/skills
npx skills add 的原理
这条命令可以拆开看。
npx 是 Node.js 生态里的临时执行工具。
你不一定要先全局安装 skills 这个命令。
当你执行：
npx skills add google/skills大致流程是：
1. npx从 npm 找到并运行skills这个 CLI2. skillsCLI 解析google/skills这个仓库地址3. 它从 GitHub 拉取或下载对应仓库 4. 找到里面符合 Agent Skills 结构的目录 5. 让你选择要安装哪些 Skill，或者直接安装默认 Skill 6. 把 Skill 复制到目标位置 7. 对应的 Agent 下次启动或刷新时，就能发现这些 Skill
所以它本质上是一个 Skill 包管理器：
负责下载、选择、复制、更新、删除 Skills。
-g 是什么意思
很多命令后面会带 -g：
npx skills add mvanhorn/last30days-skill -g这里的 -g 一般表示全局安装。
也就是装到用户级目录，让多个项目都能用。
如果不加 -g，通常会安装到当前项目目录，比如：
./.skills/项目级安装适合团队共享。
全局安装适合个人长期使用。
如果是某个项目专属的发布流程、代码规范、数据库迁移规则，装到项目里更合理。
指定安装到哪个 Agent
有些机器上同时装了 Claude Code、Codex、Cursor、Gemini CLI。
这时 skills CLI 可能会自动检测，也可能需要你指定目标 Agent。
常见写法是：
npx skills add mvanhorn/last30days-skill -g -a codex或者：
npx skills add mvanhorn/last30days-skill -g -a claude-code也可以同时指定多个：
npx skills add mvanhorn/last30days-skill -g -a codex -a cursor这里的 -a 可以理解为 agent / app / adapter。
它告诉安装器：
请把这个 Skill 安装到哪个工具能识别的位置。
不同版本 CLI 支持的目标名称可能会变，所以实际使用时以项目 README 或 npx skills --help 为准。
更新和删除
如果是用 npx skills add 安装的，后续一般也用同一个 CLI 管。
更新某个 Skill：
npx skills update last30days -g更新全部全局 Skills：
npx skills update -g查看已安装：
npx skills list -g删除某个 Skill：
npx skills remove last30days -g这就是包管理器的好处。
手动复制也能用，但更新和清理会麻烦一些。
方式二：手动安装到家目录
最朴素的方式，就是手动复制。
一个 Skill 通常长这样：
my-skill/ SKILL.md scripts/ references/你把这个文件夹放到对应工具能扫描的位置就行。
比如有些 Claude Code Skill 可以放到：
~/.claude/skills/my-skill有些 Agent Skills 宿主会扫描：
~/.agents/skills/my-skillCodex 文档里也提到过用户级和项目级的 .agents/skills 路径。
具体目录要看你使用的工具。
手动安装的好处是透明。
你知道文件在哪里。
坏处是更新要自己处理。
如果仓库更新了，你要重新复制，或者用 Git 维护。
方式三：手动安装到项目目录
如果一个 Skill 只服务当前项目，最好放项目里。
比如：
my-project/ .agents/ skills/ release-note/ SKILL.md或者某些工具用：
my-project/ .skills/ release-note/ SKILL.md项目级 Skill 适合团队协作。
比如：
• 本项目的发布流程 • 本项目的测试要求 • 本项目的代码生成规范 • 本项目的数据库迁移规则 • 本项目的文章发布流程
它可以跟代码一起提交。
新人进项目后，不用问“我们这里怎么做 release”。
Agent 也不用猜。
规则就在仓库里。
方式四：用软链接安装
开发者常用软链接。
比如你 clone 了一个 Skill 仓库：
git clone https://github.com/mvanhorn/last30days-skill.git然后把其中某个 Skill 链接到本地目录：
ln -s "$(pwd)/last30days-skill/skills/last30days" ~/.claude/skills/last30days这样做的好处是：
仓库更新后，Skill 目录也跟着变。
你不需要每次复制。
这适合开发者调试 Skill。
普通用户不一定需要。
方式五：Claude Code 插件市场
如果你用 Claude Code，有些项目更推荐走插件市场。
比如 last30days-skill 的 README 里，Claude Code 推荐方式是：
/plugin marketplace add mvanhorn/last30days-skill/plugin install last30days这种方式的好处是更贴近 Claude Code 自己的插件系统。
它不只是复制一个 Skill。
插件里还可以带：
• Skills • MCP 配置 • Hooks • 资源文件 • 版本信息 • 安装元数据
如果一个项目已经做成 Claude Code 插件，优先用它的插件市场方式通常更省心。
但注意一个坑：
不要同一个 Skill 同时用插件市场和 npx skills add 安装两遍。
有些工具不会自动去重。
你可能会在命令列表里看到两个一样的入口。
方式六：Codex 的 $skill-installer
Codex 也有自己的安装方式。
它内置了一个系统 Skill：
$skill-installer比如安装官方 curated Skill：
$skill-installer gh-address-comments安装 experimental Skill：
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan也可以让它从 GitHub 仓库路径安装。
这个方式适合 Codex 用户。
它的好处是不用离开 Codex 对话环境。
你直接告诉 Codex 要装哪个 Skill，它会调用安装脚本。
但如果你想让同一个 Skill 同时给 Cursor、Gemini CLI、Claude Code 等工具用，npx skills add 这种通用 CLI 更合适。
方式七：claude.ai 网页端上传 .skill
Claude 网页端也支持 Skills。
有些项目会在 release 里提供 .skill 文件。
安装方式通常是：
1. 下载 .skill文件2. 打开 claude.ai 3. 进入 Customize / Skills 4. 创建或上传 Skill 5. 启用需要的能力
这种方式适合不想碰命令行的人。
但它也有明显缺点：
• 更新要重新下载上传 • 不适合团队自动化管理 • 不如 CLI 方式方便排查
如果只是个人试用，一个 .skill 文件上传进去就够了。
方式八：Claude Desktop 安装 .mcpb
有些能力不只是 Skill，而是 MCP 工具。
这时项目可能会提供 .mcpb 文件。
.mcpb 可以理解成 MCP bundle。
在 Claude Desktop 里，一般是到 Settings / Extensions，然后把 .mcpb 拖进去安装。
这种方式不是单纯的 SKILL.md。
它通常会把一个本地 MCP server 装到 Claude Desktop，让 Claude 通过工具调用来完成任务。
适合这类场景：
• 本地文件处理 • 浏览器或桌面能力 • 需要 API key 的服务 • 需要长期运行的本地工具
如果项目 README 写的是 .mcpb，就不要硬套 npx skills add。
它们解决的是不同层级的问题。
方式九：OpenClaw 的 ClawHub
OpenClaw 有自己的插件生态。
有些 Skill 或工具会提供：
clawhub install last30days-official这种方式类似 Claude Code 插件市场。
如果你主要用 OpenClaw，就优先看项目有没有 ClawHub 安装方式。
原因很简单：
原生安装方式通常更懂自己的目录结构、配置文件和更新流程。
方式十：做成 Plugin 再分发
如果只是一个 SKILL.md，直接放目录就行。
但如果你要分发一整套能力，就应该考虑 Plugin。
一个 Plugin 里可以有：
• 一个或多个 Skills • MCP server 配置 • Hooks • 图标 • 截图 • 版本号 • 许可证 • 安装入口
比如 Codex Plugin 常见结构是：
my-plugin/ .codex-plugin/ plugin.json skills/ my-skill/ SKILL.mdClaude Code 也有自己的插件结构和 marketplace 方式。
Plugin 比单个 Skill 更适合团队和社区分发。
如果你只是自用，别一开始就搞复杂。
如果你要给别人安装，就应该考虑插件化。
怎么选
最简单的判断方法：
如果项目 README 写了 npx skills add：
优先用 npx skills add。
如果 README 写了 Claude Code 插件市场：
Claude Code 用户优先用插件市场。
如果你用 Codex，并且装的是 OpenAI 官方 curated / experimental Skills：
用 $skill-installer 很方便。
如果你用 claude.ai 网页端：
下载 .skill 上传。
如果你用 Claude Desktop，并且项目提供 .mcpb：
用 .mcpb 装扩展。
如果你用 OpenClaw：
先看有没有 clawhub install。
如果你要团队共享：
放项目目录，提交到 Git。
如果你在开发 Skill：
clone 仓库，再用软链接。
安装前一定要看什么
Skill 不是普通文档。
它可能会让 Agent 运行脚本。
所以安装前至少看三样东西：
• SKILL.md写了什么• scripts/里有没有危险命令• README 里有没有说明会读写哪些文件、需要哪些权限
如果它还要求 API key、浏览器 cookie、系统权限，更要谨慎。
不要因为命令很短，就直接复制执行。
尤其是：
npx skills add xxx/xxx这类命令会从网络下载东西。
仓库来源不可信，就不要装。
安装后为什么没生效
常见原因有几个。
第一，装错目标 Agent。
你以为装给 Codex，其实 CLI 自动装到了 Claude Code。
可以用 -a codex、-a claude-code 这类参数明确指定。
第二，没重启。
很多 Agent 不会实时扫描新 Skill。
重启一下最直接。
第三，装了两份。
比如 Claude Code 插件市场装了一份，npx skills add 又装了一份。
这会导致入口重复。
第四，Skill 描述太模糊。
Agent 不知道什么时候该用它。
一个好的 description 应该写清楚触发场景。
比如：
description: 当用户要求把 Markdown 文章中的本地图片上传到图床，并替换为远程 URL 时使用。不要写成：
description: 帮助用户处理内容。这太泛了。
一句话总结
npx skills add 是现在最常见的通用安装方式。
它的原理就是用 npm 临时运行 skills CLI，从 GitHub 下载 Skill，再安装到目标 Agent 能识别的位置。
Claude Code、Codex、OpenClaw、Claude Desktop、claude.ai 又各自有自己的原生安装入口。
实际使用时别纠结哪个“更正统”。
看项目 README。
看你用的 Agent。
看你是个人用、项目用，还是团队分发。
大多数时候，按这个顺序选就够了：
README 推荐方式 > 目标 Agent 原生方式 > npx skills add > 手动安装这样最稳，也最少折腾。
如果你也在研究 Claude Code、Codex、Cursor 这类 Agent 工具，想继续看我拆工具、装法和真实使用场景，关注我，后面会继续整理更适合普通人和一线实操者的 AI 工作流。
有帮助👉 「点赞」「转发」「小心心」
也欢迎在评论区 灵感流淌！
