个人技能和仓库技能分开放
~/.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。
禁用某个技能：
[[skills.config]]
path = "/home/you/.agents/skills/noisy/SKILL.md"
enabled = false
要分发、带 MCP/App 配置时，打成 plugin，不要只拷贝文件夹。技能装太多、目录被截断时，先这里关掉不用的，再考虑 skills.max_context_tokens。