四级生态
Skill 按存放位置与共享范围，可分为用户级、项目级、企业级、社区级四个层次，由内向外覆盖范围逐级扩大：
| 层级 | 存放位置 | 共享范围 | 适用场景 |
|---|---|---|---|
| 用户级 | 用户家目录下的 agent 配置目录 | 仅当前用户，跨所有项目可用 | 个人偏好、私有工作流、跨项目复用的通用能力 |
| 项目级 | 项目根的 agent 配置目录，随仓库进版本控制 | 团队共享，所有协作者共用一份 | 业务规则、项目专属 SOP、需团队协同沉淀的能力 |
| 企业级 | 由组织管理员统一部署，自动下发到成员工作区 | 整个组织共用，集中管理 + 自动更新 | 公司级合规流程、敏感数据处理、统一对外 SOP |
| 社区级 | 公开仓库 / 标准生态 | 全网开放，开箱即用 | 通用领域能力，如 PDF / DOCX / XLSX 文档处理 |
各平台的具体路径约定不同，例如：
| 平台 | 用户级 | 项目级 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | <project>/.claude/skills/ |
| Claude.ai | Settings > Capabilities > Skills（GUI 上传） | —（不适用） |
| OpenAI Codex CLI | ~/.agents/skills/ | <project>/.agents/skills/ |
| CodeBuddy | ${HOME}/.codebuddy/skills/ | <project>/.codebuddy/skills/ |
NOTE
Codex 用 .agents/skills/ 而非 .codex/skills/ — Codex 沿用 AGENTS.md 开放标准的命名约定，与 Cursor、Amp、Windsurf 等家族保持一致。~/.codex/skills/ 也能被识别但官方不推荐。
Codex 独有：4 层发现位置（按优先级递增）
Codex 的发现机制比"用户级/项目级"更细——会从当前目录向上递归扫描所有 .agents/skills/，加上系统级位置共 4 层：
| Scope | 位置 | 建议用途 |
|---|---|---|
| REPO（递归） | $CWD/.agents/skills 与各级父目录 | 微服务 / 子模块级别的局部 Skill |
| REPO 根 | $REPO_ROOT/.agents/skills | 整个仓库共享，随版本控制 |
| USER | $HOME/.agents/skills | 跨项目个人 Skill |
| ADMIN | /etc/codex/skills | 机器 / 容器系统级，多用户共用 |
例如在 monorepo 里，根目录放整个仓库通用的 Skill，子目录 apps/web/.agents/skills/ 放只在 web 应用上下文用的 Skill —— 切换到 apps/web 目录跑 Codex 时两层都会被加载。
NOTE
企业级（Organization-level）由 Anthropic 在 2025 年 12 月推出，适用于使用 Claude 企业版的组织。其它平台陆续跟进中。如果你只是个人或小团队使用，用户级 + 项目级 这两层就足够了。
TIP
使用建议：先搜索，再编写。 动手写新 Skill 之前，先到社区生态查是否已有现成方案；没有再自行实现，并按"个人 / 团队 / 全网"判断沉淀位置。社区入口可参考：
- anthropics/skills — Anthropic 官方示例库
- agentskills.io — 开放标准与跨平台 client showcase
选层心法
- 个人高频小工具 → 沉淀到用户级，免得每个项目都重写
- 业务专属 SOP → 沉淀到项目级，跟代码一起进版本控制
- 公司统一规范 → 沉淀到企业级，集中部署、自动更新
- 跨团队的通用能力 → 提交到社区级，让生态共建
理解了"放在哪"之后，下一步建议阅读 SKILL.md 学习正文该怎么写。