Agent Skills 推荐与使用指南：2026 怎么安装，Claude Code / Codex 该装哪些技能

2026 年 9 月，Claude Code、Codex、Cursor 和一批开源 Coding Agent 已经共用同一套开放格式：一个目录加 SKILL.md。技能不是「又一个插件市场」，而是按需加载的流程说明书。很多人还在把发布清单、评审步骤、回滚口令写进 CLAUDE.md 或 AGENTS.md，或者从 GitHub 一键装几十个社区包。真正该比的不是装了多少，而是这段流程该不该每次进上下文、描述会不会误触发、目录里的 scripts/ 会不会在本机同权执行。本文不复述开放标准全文，只回答安装与选型：Claude Code 和 Codex 该装哪些技能、怎么装、怎么验收。

为什么还在往全局提示词里塞流程，就已经选错了

旧方式和新方式的冲突很具体。旧方式是提示词优先：仓库根目录一份越写越长的手册，每次会话都整份送进模型。新方式是技能优先：稳定事实留在 CLAUDE.md / AGENTS.md，重复的多步流程做成 SKILL.md，Agent 先只看见名字和描述，真正用到才加载正文。同一条「帮我发这次版本」，旧方式每轮都付说明书；新方式只在发布任务上付。

这件事现在才变成排期优先级，有三个原因。第一，Claude Code 已经把自定义斜杠命令并进 Skills：.claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都能变成 /deploy，旧命令文件继续可用，但新能力（配套文件、自动触发、子 Agent）只在技能目录上。第二，Codex 按开放标准扫 .agents/skills，并从当前目录向上走到仓库根；个人技能走 ~/.agents/skills，旧路径 ~/.codex/skills 仍会被扫到——装错目录会表现为「明明装了却调不出来」。第三，Vercel 的 npx skills 已经能把同一份技能写进 Claude Code、Codex、Cursor 等几十个 Agent 的目录。跨工具复用成立的前提，是你没有把技能写成只认一家私有 frontmatter。

还有一层经常被漏掉：Skills 不是 MCP，也不是 Function Calling。MCP 和工具协议管的是「模型怎么调一个活接口」；技能管的是「这段人类流程何时被加载」。协议层怎么设计，见 Function Calling 是什么。跨会话的动态状态也不该塞进技能正文，那是记忆层的事，见 自建 Agent Memory vs SaaS。套件本身怎么选，见 Pi vs Claude Code vs Codex。

Agent Skills 怎么分类

把技能名摊平并列，收藏夹一定膨胀。按「谁维护、何时加载、有没有副作用」分成三类，缺一类就只剩口碑。

Claude Code 的捆绑技能是提示词编排，不是固定二进制：/code-review、/debug、/run、/verify、/run-skill-generator、/doctor。后三个从 v2.1.145 起能根据 README 或 package.json 推断启动方式；复杂项目应跑一次 /run-skill-generator，把安装命令、环境变量和启动脚本写成仓库内技能，避免每次重新发现。Codex 捆绑的是 skill-installer、skill-creator、review-agent、openai-docs 一类引导器。两边都遵循「先看见名字和描述，用到再读正文」的渐进披露，所以描述字段不是装饰——太短不触发，太宽乱触发。

核心对比：入口、执行、上下文、人群

真正差异在于入口，而不是哪家实验室的技能市场更大。三张牌必须用同一套列名。

第二张表只补「你以为装上了」的坑，列名对齐，避免散文式空评。

# Claude Code — project skill (this repo only)
mkdir -p .claude/skills/review-change

# Codex — project skill (open .agents/ convention)
mkdir -p .agents/skills/review-change

# Personal skill, every repo on this machine
mkdir -p ~/.claude/skills/review-change
mkdir -p ~/.agents/skills/review-change

# Cross-agent package manager (Vercel skills CLI)
npx skills add vercel-labs/agent-skills --skill react-best-practices -a claude-code
npx skills add vercel-labs/agent-skills --skill react-best-practices -a codex

# Codex bundled installer (often writes ~/.codex/skills)
# Inside a Codex session:
# $skill-installer linear

最小可用的 SKILL.md 只需要开放标准里的 name 和 description。下面这条够用来验收「会不会触发、会不会读正文」，先不要加 scripts/。

---
name: review-change
description: Reviews an uncommitted diff and lists risks. Use when the user asks what changed, wants a commit message, or asks to review the working tree. Do not use for greenfield feature design.
---

## Current changes

Run git diff HEAD and summarize in three bullets.
Flag missing tests, hardcoded secrets, and edits outside the named module.
If the diff is empty, say so and stop.

Claude Code / Codex 该装哪些技能

推荐组合不是「官方商店 Top 10」，而是按副作用分层。捆绑技能默认留着；项目技能只留你们每周会重复的流程；跨仓库规范只装读过正文的那几个。

独立开发者先做一条 review-change 和一条 release，再决定要不要 React 规范。小团队把「开 PR 前必须跑的检查」写成项目技能，把个人偏好留在用户级 CLAUDE.md，不要把客户路径写进用户级技能。企业把技能当代码：PR 审 SKILL.md 和 scripts/，不允许成员把未审计包链到 ~/.agents/skills。

场景怎么选

推荐组合

A — 独立开发者、一条主 CLI： 捆绑技能保持开启。仓库里只提交两条项目技能：评审未提交 diff、按现有脚本发版。描述写清「何时用 / 何时不用」。写文件和 bash 放到容器，或放到按会话隔离的远程 Mac。节点月费和套餐对照见 Mac mini 定价。

B — 小型产品团队、Claude Code + Codex 并存： 规范类技能用 npx skills 按 Agent 安装 react-best-practices 或 web-design-guidelines，不要整库通装。发布和回滚只放项目目录，随 PR 审。个人口癖留在用户级提示词，不进技能。两套 CLI 用同一条样本发布任务验收触发，不要假设「一边能调、另一边也能调」。

C — 企业或高安全： 技能当代码：目录、脚本、描述进 PR。禁止用户级目录链未审计包。带网络或密钥的脚本只在可销毁节点跑。账号与交付边界见 帮助中心；需要隔离工作区时从 Mac mini 租用 看节点，而不是把本机当试验场。

常见误区

1. 按收藏夹选技能： 「装得越多 Agent 越能干」。每条宽描述都是一次误触发预算。
2. 把流程写进全局提示词： 发布清单每次会话都在，等于每轮付说明书。
3. 假设路径通用： Claude Code 的 .claude/skills 不会被 Codex 当默认根；Codex 安装器还可能写到 ~/.codex/skills。
4. 未读脚本就装用户级： scripts/ 跟启动用户同权。先项目目录、先隔离节点。
5. 用社区技能代替测试： /verify 和你们的 CI 不是互斥。技能不能替代红绿测试。

落地步骤：7 步

1. 打开 CLAUDE.md / AGENTS.md，把超过一段的流程标成候选：发布、评审、回滚、生成变更说明。事实留下，步骤搬走。
2. 先写一条没有 scripts/ 的 SKILL.md，描述写清「何时用 / 何时不用」。用 /review-change 或 $review-change 手动触发一次。
3. 再用一句正常口语试自动触发。误触发就改描述，不要靠再装一个技能去覆盖。
4. Claude Code 放到 .claude/skills/，Codex 放到 .agents/skills/。需要同时给 Cursor 或其他 Agent，用 npx skills add … -a，不要手抄错目录。
5. 捆绑技能加 2–4 个项目技能就停。社区包只在读完 SKILL.md 和脚本之后进项目目录，不进 ~/.claude/skills 或 ~/.agents/skills。
6. 带 scripts/ 的技能先在容器或远程 Mac 跑。密钥不进提示词、不进技能正文。会话结束能清工作区。
7. 用同一条发布或评审任务做验收：有没有触发、改了哪些文件、测试在不在你们的 CI 里绿。本机缓存冒充通过，不算验收。

FAQ

Skills 和 CLAUDE.md / AGENTS.md 有什么区别？

稳定事实放进 CLAUDE.md 或 AGENTS.md，每次会话都会读。重复的多步流程放进 Skills，正文只在用到时加载。把发布清单塞进全局提示词，等于每轮都付说明书。

Claude Code 和 Codex 的技能能共用吗？

能共用 SKILL.md 开放格式，但不能假设路径和调用方式一样。Claude Code 看 .claude/skills/ 和 ~/.claude/skills/；Codex 看 .agents/skills/ 和 ~/.agents/skills/，旧路径 ~/.codex/skills 仍会被扫到。跨 Agent 用 npx skills 指定 -a。

该不该把 GitHub 上热门技能一键全装？

不该。描述写得太宽会误触发；scripts/ 会在本机同权执行。先读 SKILL.md 和脚本，再装进项目目录，不要先装进用户级目录污染所有仓库。

Codex 的 $skill-installer 和 npx skills 有什么不同？

$skill-installer 是 Codex 捆绑安装器，常写到 ~/.codex/skills。npx skills 是跨 Agent 的包管理器，可指定 claude-code 或 codex。手写技能优先放 .agents/skills 或 .claude/skills，两边都查一遍再判断「没装上」。

带脚本的 Skills 能在日常笔记本上跑吗？

能跑，但不建议对不熟悉的仓库或生产密钥这么做。先放到容器或远程 Mac 节点，确认触发范围和写盘边界，再决定是否提交到团队仓库。

总结

2026 年选 Agent Skills，不要再把社区排行榜当成购物车。先按三类入口选：捆绑技能负责官方回退；项目技能负责你们每周重复的发布和评审；跨仓库规范只装读过的那几份。 Claude Code 和 Codex 共用格式，不共用默认目录。描述写窄，脚本后装，用户级目录当例外而不是默认。按 7 步把拆分、触发、路径和可清节点写进验收。远程节点从 租用页 和 定价页 查看，账户问题走 帮助中心。

延伸阅读

• Pi vs Claude Code vs Codex：2026 套件怎么选 →
• Function Calling 是什么：OpenAI / Gemini / Claude 对照 →
• 自建 Agent Memory vs SaaS Memory →