想教寫程式 Agent 一件它預設做不好的事,skill 是最簡單的方法:一套設計規範、一份審查檢查清單,或一種省 token 的做法。這篇說明 Claude Code 和 Codex 的 skill 放在哪裡、怎麼手動安裝,以及怎麼不碰命令列就管理它們。
Skill 是什麼?
skill 是一個含有 SKILL.md 檔案的資料夾:用 Markdown 寫的指示,最上方有簡短的名稱和描述,再加上它需要的腳本或參考檔案。Agent 會讀取已安裝 skill 的描述,只有在任務需要時才載入完整指示,所以 skill 在用到之前幾乎不佔脈絡。
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Claude Code 和 Codex 去哪裡找 skill?
| Agent | 個人 skill(所有專案) | 專案 skill |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
repo 裡的 .claude/skills/<name>/ |
| Codex | ~/.codex/skills/<name>/ 或 ~/.agents/skills/<name>/ |
依 Codex 文件 |
如果你設定了 CLAUDE_CONFIG_DIR 或 CODEX_HOME,個人資料夾的位置會跟著移動。
手動安裝 skill
- 找到 skill 的 repo,以及含有
SKILL.md的那個資料夾。 - 把那個資料夾複製到你的 skills 目錄:
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- 開一個新的 Agent 工作階段,讓它載入 skill。
更新就是再複製一次,而且新版出問題時沒辦法復原,所以請先備份舊資料夾。
只安裝你信任的 skill。 skill 可能附帶腳本,Agent 會用你的權限執行它們。請先讀過 SKILL.md 和所有腳本。
用 Vibe Console 管理你自己的 skill repo
在 Vibe Console 的 Skill 面板裡,以 owner/repo 或 https://github.com/owner/repo 的格式加入你信任的 GitHub repo。替它的卡片選一個分類,再選擇要為 Claude Code 或 Codex 安裝哪些 skill。列表儲存在你的 Mac 上;Vibe Console 本身不提供 skill 檔案。你可以從列表移除任何卡片,已經安裝的東西不會因此被解除安裝。
安全更新,可以復原
Vibe Console 會檢查已安裝的 skill 是否有更新,並標示 「有可用更新」;如果磁碟上的檔案和來源已經不一致,則標示 「來源不同 — 請檢視變更」。更新時會保留舊檔案的備份。新版造成問題時,按 「復原」,或按 「開啟備份」 檢查舊檔案。
常見問題
skill 在 Claude Code 和 Codex 都能用嗎?
SKILL.md 格式兩邊都通用,但每個 Agent 從自己的資料夾載入 skill。你用幾個 Agent,就要替每個各安裝一次。
安裝 skill 會拖慢 Agent 嗎?
幾乎不會。在任務需要之前,Agent 只會讀每個 skill 的簡短描述。
怎麼移除 skill?
從 skills 目錄刪掉它的資料夾,再開一個新的工作階段。
免費試用 Skill 面板 14 天:下載 Vibe Console。
