簡短回答
- 1把 Skill 的資料夾放在
~/.agents/skills/就能在每個 repository 中使用，放在某個 repo 的.agents/skills/則只限於該 repo。 - 2Codex 要求
SKILL.md中同時有name（最多 64 個字元）和description（最多 1,024 個字元）。 - 3輸入
$加上 Skill 名稱來執行它，或輸入/skills從清單中挑選。 - 4想要現成的？瀏覽一個指令就能安裝的 Codex Skills。
開始之前
Skill 可以在三個地方使用：Codex CLI、Codex IDE 擴充功能，以及 ChatGPT 桌面版中的 Codex。若要用 CLI 從 Skillry 安裝，還需要 macOS 或 Windows，以及 Node.js 22 以上版本。
如何把 Skill 加到 Codex
Codex 和 Skillry CLI 使用相同的預設資料夾 ~/.agents/skills/，所以不需要任何額外參數。挑一種適合你的方式即可。
- 1
在 Skillry 上打開這個 Skill，點選複製安裝提示詞，再點對話框中的複製。
- 2
貼到 Codex 中送出。Agent 會讀取 Skillry 的安裝說明，並自行執行正確的指令。
安裝提示詞 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
瀏覽器要求你核准裝置代碼時，按下核准。
你應該會看到： Codex 回報它安裝的版本，以及它使用的資料夾（位於
~/.agents/skills/底下）。
- 1
登入一次。瀏覽器會開啟視窗，顯示一組讓你核准的裝置代碼。
終端機 npx --yes skillry-cli@latest login - 2
安裝。不需要加任何參數，因為 CLI 的預設資料夾就是 Codex 會讀取的那個。
終端機 npx --yes skillry-cli@latest install <slug>你應該會看到：
Installed <slug> <version> to ~/.agents/skills/<slug>
在 Skill 頁面點選下載 ZIP，或使用你從別處取得的 Skill 資料夾。安裝前先閱讀 SKILL.md 和 scripts/ 裡的所有內容，因為 Agent 會照著那些指示做，也可能執行那些腳本。然後移動整個資料夾：
mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/ZIP 解壓後常會多出一層，例如 my-skill/my-skill/SKILL.md。SKILL.md 必須直接位於 Skill 的資料夾內，否則 Agent 會找不到它。
Codex 也有自己的安裝工具 $skill-installer，用來安裝 OpenAI 目錄中的 Skill。它會把 Skill 放在 ~/.codex/skills/，這是 Codex 仍會讀取的舊版資料夾，所以兩種安裝工具裝的 Skill 會一起出現。
確認 Codex 找到了它
在 CLI 或 IDE 擴充功能中，輸入 /skills，或輸入 $ 並開始打名稱。在 ChatGPT 桌面版中，打開側邊欄的 Skills。Codex 會自行偵測新的 Skill；如果沒有出現，請重新啟動 Codex。
如何在 Codex 中執行 Skill
輸入 $、Skill 的名稱，接著寫下你的需求：
$launch-page Parcelo, a parcel-tracking dashboard for small online shops確認它能運作之後，你就可以用一般說法提出需求，Codex 會挑選描述相符的 Skill。裝了很多 Skill 時，Codex 會縮短描述，讓整份清單塞進約 2% 的 context window。把主要用途寫在描述的第一句，才不會被截掉。
Codex 會到哪裡找 Skill
Codex 會從五個範圍收集 Skill。日常會用到的是其中兩個：你的個人資料夾和 repository 的資料夾。
| 範圍 | 位置 |
|---|---|
| Repository | 從你啟動 Codex 的資料夾一路往上到 repo 根目錄，每個資料夾中的 .agents/skills/ |
| 個人 | ~/.agents/skills/ |
| 個人（舊版） | ~/.codex/skills/，仍會讀取（文件中沒寫，但 Codex 原始碼可以證實） |
| 管理員 | /etc/codex/skills/ |
| 系統 | Codex 內建，例如 $skill-creator 和 plan |
Codex 不會合併兩個同名的 Skill。兩者都可能出現在選單中，所以請刪除或重新命名你不要的那份。
Codex Skill 與 AGENTS.md 的差別
Codex 每次執行開始時都會讀取 AGENTS.md，所以它適合放一直適用的簡短規則。Skill 只在任務需要時才載入，所以適合放你會重複使用的較長流程。
需要時才載入
.agents/skills/中的一個資料夾- 任務符合時，或你輸入
$name時載入 - 適合可重複的多步驟工作
每次執行開始時讀取
- 先讀
~/.codex/AGENTS.md，再從 repo 根目錄往下到你啟動的位置，每個資料夾讀一個檔案 - 離你越近的檔案會覆蓋先前的；預設總計上限 32 KiB
- 適合簡短規則：測試指令、程式碼風格、限制
一個好用的分工方式：AGENTS.md 控制在大約一個螢幕的規則，任何需要逐步執行的內容都移進 Skill。Skill 與指示檔有更深入的說明。
Codex Skill 沒有出現？對照你的症狀
找不到的 Skill 通常是放錯資料夾，或解壓後多了一層。在左欄找到你看到的現象。
| 你看到的現象 | 解法 |
|---|---|
/skills 裡沒有它 | 把它移到 ~/.agents/skills/<name>/，並檢查 ZIP 是否多出一層 |
| 有列出但沒有描述 | 修正 frontmatter。Codex 需要同時有 name 和 description |
| 找不到專案 Skill | 在 repository 內啟動 Codex |
在 ChatGPT 桌面版中輸入 $ 找不到任何東西 | 這是已回報的 bug（openai/codex#28505）。檢查 /skills、重新啟動，或試著在 ~/.codex/skills/ 放一份（我們尚未實測） |
常見問題
Codex 的 Skill 存放在哪裡？
你自己的 Skill 放在 ~/.agents/skills/，repository 內的放在 .agents/skills/，管理員用的放在 /etc/codex/skills/。Codex 也會讀取舊版的 ~/.codex/skills/，$skill-installer 就是把 Skill 裝在那裡。
Codex Skill 和 AGENTS.md 有什麼不同？
AGENTS.md 在每次執行開始時都會讀取。Skill 只在任務需要時才載入。
Codex Skill 能在 ChatGPT 中使用嗎？
獨立的 Skill 可以在 ChatGPT 桌面版、Codex CLI 和 IDE 擴充功能中使用。若要在網頁版或行動版 ChatGPT 中使用，請把它包進 plugin 發布。
怎麼製作自己的 Codex Skill？
請 $skill-creator 幫忙。它是 Codex 內建的系統 Skill 之一。
參考來源
這篇指南對你有幫助嗎？
