Skills
Skill（技能）把「這件事我們每次都這樣做」包成資料夾：一份 SKILL.md，加上可選的腳本與參考文件。Codex 先只看到名稱與描述，真的要用時才載入全文，所以可以準備很多技能而不會一開始就塞爆上下文。
官方說明：Agent Skills。CLI／IDE 用 /skills 或 $ 提到技能。
何時用 Skill，何時用 AGENTS.md
| 放哪 | 適合 |
|---|---|
AGENTS.md |
幾乎每次都要遵守的短規則 |
| Skill | 有步驟、有例外、可能含腳本的可重用流程 |
| MCP | 要即時讀寫外部系統（issue、設計稿、文件服務） |
修 CI、開 PR、依公司模板產檔，通常是 Skill。「用 uv、不要亂加依賴」則留在 AGENTS.md。
最小結構
.agents/skills/fix-ci/
SKILL.md
scripts/ # 可選
references/ # 可選
agents/openai.yaml # 可選：顯示名稱、是否允許隱式觸發、MCP 依賴
SKILL.md 必須有 name 與 description：
---
name: fix-ci
description: 診斷並修復 GitHub Actions 失敗。使用者提到 CI 紅燈、workflow 失敗時使用；不要用來改產品功能。
---
1. 讀取失敗的 workflow log。
2. 重現最小失敗案例。
3. 只改讓 CI 變綠所需的檔案。
4. 說明原因與如何驗證。
description 要寫「何時該用、何時不該用」，因為隱式觸發靠這段文字。
Codex 從哪裡載入
| 範圍 | 位置 | 用途 |
|---|---|---|
| 專案 | 從工作目錄往上到 repo 根的 .agents/skills |
團隊共享、可進 Git |
| 使用者 | ~/.agents/skills |
你個人、跨 repo |
| 系統 | Codex 內建 | 例如 skill-creator |
CLI 也可用 $skill-installer 安裝精選技能，或 $skill-creator 用對話產生新技能。若流程比較適合「做一次給它看」，桌面 App 的 Record & Replay 能把示範收成可檢查、可編輯的技能。
停用但不刪除：在 ~/.codex/config.toml 用 [[skills.config]] 指到該 SKILL.md 並設 enabled = false。
要發布給別人安裝時，再打包成 plugin（可一併帶 MCP）。本機作者直接放資料夾即可。
推薦影音
官方「Record & Replay」示範如何把實際操作收成技能；若該片不在 YouTube 公開嵌入，請到 Codex 影片目錄 搜尋 Record & Replay in Codex。技能與 MCP 搭配的操作示範見 MCP 與 優質 YouTube。