---
title: "个人技能和仓库技能分开放"
summary: "~/.agents/skills 跟你走；.agents/skills 跟仓库走。系统级还可放 /etc/codex/skills。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["路径", ".agents", "plugins"]
canonical: /tips/skill-locations/
---

# 个人技能和仓库技能分开放

~/.agents/skills 跟你走；.agents/skills 跟仓库走。系统级还可放 /etc/codex/skills。

| 位置 | 范围 |
| --- | --- |
| `.agents/skills/<name>/SKILL.md` | 仓库/团队，从 cwd 搜到仓库根 |
| `$HOME/.agents/skills/...` | 你的个人技能 |
| `/etc/codex/skills/...` | 管理员/系统 |
| 内置 | Codex 自带 |

`SKILL.md` 必须有 `name` 和 `description`。可选：`scripts/`、`references/`、`assets/`、`agents/openai.yaml`。

禁用某个技能：

```toml
[[skills.config]]
path = "/home/you/.agents/skills/noisy/SKILL.md"
enabled = false
```

要分发、带 MCP/App 配置时，打成 plugin，不要只拷贝文件夹。技能装太多、目录被截断时，先这里关掉不用的，再考虑 `skills.max_context_tokens`。

## 来源

- [OpenAI · Customization](https://developers.openai.com/codex/concepts/customization)