Claude Code Skill 是包含 SKILL.md 檔案的資料夾,當任務符合 Skill 的描述時,Claude Code 會按需載入該檔案。你只需將資料夾放入專案中的 .claude/skills/(或放入 ~/.claude/skills/,即可套用到每個專案),Claude Code 會讀取前置資料,之後在相關時載入其中的指示。以下將介紹 Skill 的存放位置、它們與 CLAUDE.md、斜線指令及 MCP 的差異、3 步驟安裝方式,以及目前可在 Claude Code 中使用的 15 項開發者 Skill。

Claude Code Skill 實際上是什麼
Skill 是一個目錄,其中包含一個必要檔案, SKILL.md,以及選用的幾個支援檔案(參考文件、範本、小型指令碼)。SKILL.md 開頭是 YAML 前置資料,其中包含 Claude Code 所關心的兩個欄位: 名稱 以及 description。前置資料之下是純 Markdown:角色、流程、輸出格式與規則。
重要的設計決策是,Skill 會延遲載入。Claude Code 會在上下文中保留每個已安裝 Skill 的名稱與描述的簡短索引。當你的請求看起來符合某項 Skill 時,它才會讀取完整的 SKILL.md 並遵循其中的指示。若不符合,該 Skill 幾乎不會消耗任何資源。這就是為什麼撰寫完善的描述比檔案中的任何其他內容都重要:在決定是否開啟 Skill 之前,Claude Code 唯一看得到的就是描述。
你在 KissMySkills 購買 Skill 時取得的內容,就是同一個 SKILL.md:一個 .md 檔案加上一個 README,與你上傳到 Claude Project、自訂 GPT 或 Gemini Gem 的內容完全相同。
Skill 的存放位置:專案層級與使用者層級
Claude Code 會在兩個位置尋找 Skill。
-
專案層級:
<repo>/.claude/skills/<skill-name>/SKILL.md。提交這個資料夾後,所有複製儲存庫的團隊成員都能取得這項 Skill。適合用於與此程式碼庫相關的內容:你的審查清單、部署操作手冊、API 文件風格。 -
使用者層級:
~/.claude/skills/<skill-name>/SKILL.md。在你機器上的每個專案中都可用,團隊成員看不到。適合用於個人習慣:你偏好的提交訊息撰寫方式、測試結構,以及你在不同客戶專案中使用的角色設定。
如果兩個位置都有相同名稱的技能,專案層級的版本優先。一般開發人員技能放在使用者層級,任何具有專案特定規則的技能則放在專案層級。
Claude Code 如何探索技能
探索機制由以下項目驅動: description frontmatter 中的 description 欄位,而不是檔案名稱,也不是資料夾名稱。像「適用於提取要求的程式碼審查」這樣的描述很薄弱,因為只有在你字面上說出「review」時才會觸發。像「檢查差異、提取要求和變更檔案中的錯誤、安全性問題、遺漏的測試和不清楚的命名。當使用者要求檢查、審查、稽核或批評程式碼時使用」這樣的描述,才會在開發人員實際使用的措辭中觸發。
需要知道的三件事:
- 工作階段開始時會為技能建立索引。如果你在工作階段中途新增資料夾,請開始新的工作階段,或要求 Claude Code 重新讀取其技能。
- 描述應該說明在何時使用技能,而不只是說明它是什麼。觸發片語應包含在其中。
- 你隨時可以透過指定技能來強制使用它:「在這個差異上使用程式碼審查技能」。自動探索只是便利功能,不是唯一途徑。
技能 vs CLAUDE.md vs 斜線指令 vs MCP 伺服器
這四者經常被混淆,但它們解決的是不同問題。
| 機制 | 它是什麼 | 載入時機 | 最適合 |
|---|---|---|---|
| CLAUDE.md | 位於儲存庫根目錄(或 ~/.claude/CLAUDE.md)的專案記憶檔案 | 永遠,每一輪 | Claude 絕不能忘記的資訊:技術堆疊、慣例、指令、不可觸碰的區域 |
| Skill | 包含 SKILL.md 和選用支援檔案的資料夾 | 當描述符合時按需使用 | 你偶爾需要的專家程序:審查、稽核、測試計畫、執行手冊 |
| 斜線指令 | 位於 .claude/commands/ 中、以 /name 執行的 Markdown 檔案 | 只有在你輸入指令時 | 你刻意觸發的可重複操作:/deploy-checklist、/write-pr |
| MCP 伺服器 | 提供工具的外部程序(資料庫、API、瀏覽器) | 整個工作階段都能使用的工具 | 賦予 Claude 執行某件事的能力,而不是教它如何做好這件事 |
簡短來說:CLAUDE.md 是始終開啟的上下文,技能是需要時才出現的專業知識,斜線指令是你按下的按鈕,而 MCP 伺服器則是一雙手。良好的設定會同時使用這四者:用 MCP 讓 Claude 能夠執行操作,用技能讓它像資深工程師一樣行動。
一個後果是:不要把 2,000 字的審查清單貼進 CLAUDE.md。你在重新命名變數時,它也會一直存在於上下文中。把它做成技能。
3 步驟安裝 Claude Code 技能
步驟 1:取得 SKILL.md。從你的 KissMySkills 訂單下載 .md 檔案(或自行撰寫)。如果檔案尚未命名為 SKILL.md,請重新命名。frontmatter 至少需要包含 name: 與 description:;市集上販售的每項技能都會隨附這兩項。
步驟 2:建立資料夾。在儲存庫根目錄中:
mkdir -p .claude/skills/code-reviewer
mv ~/Downloads/yuri-code-reviewer.md .claude/skills/code-reviewer/SKILL.md
若要進行使用者層級安裝,請將 .claude/skills 的 ~/.claude/skills。資料夾名稱應與 名稱 frontmatter 中的欄位,使用小寫字母與連字號。
步驟 3:在該目錄中啟動新的 Claude Code 工作階段,並要求執行描述涵蓋的事項。你應該會在回答中看到技能的結構(審查區段、嚴重程度標籤,以及技能定義的其他內容)。不需要設定檔,也不需要重新啟動其他程式。
如果你想閱讀包含螢幕截圖與 Claude.ai 對應版本的詳細教學,請閱讀如何安裝 Claude 技能。
如何測試技能
測試只需五分鐘。
- 觸發測試。使用不同措辭提出三個應觸發技能的請求(「審查這個」、「這個函式有任何問題嗎?」、「檢查這個 PR」)。如果其中一個沒有觸發,請用該措辭擴充描述。
- 負面測試。提出一個相鄰但不應觸發技能的問題(「重新命名這個變數」)。如果技能仍然載入,表示描述範圍太廣。
- 輸出測試。將回答與 SKILL.md 的承諾進行比較。如果技能寫著「始終列出每項發現的嚴重程度」,但輸出中沒有任何嚴重程度,表示系統讀取了指示卻沒有遵循;請將指示縮短並寫得更明確。
- 明確測試。直接說出技能名稱。如果這樣有效,而自動探索無效,問題百分之百出在描述上。
在撰寫或購買技能之前,若想了解設計良好的 SKILL.md 應該是什麼樣子,這裡逐行說明了 12 個真實的 SKILL.md 檔案。
15 個適用於開發人員的 Claude Code 技能
以下內容皆來自 Claude Code 技能集合。每項技能皆為一次性購買,包含一個 .md 技能檔案與 README,並適用 30 天退款保證。價格以撰寫本文時為準。
程式碼品質
Yuri - 程式碼審查員 AI Skill ($29):對任何差異內容、檔案或 PR 執行結構化審查,並依嚴重程度分組列出發現事項。
Soren - 程式碼稽核 AI Skill ($29):審查整個程式碼庫,而非單一變更,找出結構性技術債、無效程式碼、不一致的模式與高風險區域。非常適合接手既有儲存庫後的第一週使用。
Albert - AI 程式碼審查 agent ($32):針對快速迭代流程調校的審查 agent,專注於變更行中的正確性與邊界案例。
Mira - QA 工程師 AI Skill ($29):將功能描述或差異內容轉換為測試案例、邊界案例與測試計畫,接著使用你的框架撰寫測試。當你要求 Claude Code「新增測試」並希望涵蓋不只是正常流程時,特別實用。
交付
Rami - DevOps 工程師 AI Skill ($29):以真正 DevOps 工程師具備的謹慎態度處理 CI/CD 管線、Dockerfile、基礎架構即程式碼與事故處理手冊。它會在撰寫部署步驟前先詢問回滾方案。
Max - 全端開發人員 AI Skill ($29):全方位的通才:跨越 API、資料層與 UI 建立功能骨架,並維持各部分的一致性。如果你只安裝一個交付 Skill,就選這個。
Lena - 前端開發人員 AI Skill ($29):現代前端技術棧的元件結構、狀態、無障礙功能與響應式行為。避免 Claude Code 交付一團充斥 div 和內嵌樣式的混亂程式碼。
Niko - 後端開發人員 AI Skill ($29):伺服器端程式碼的 API 設計、資料建模、錯誤處理與效能。特別擅長處理通用 prompts 會略過的枯燥細節(驗證、分頁、冪等性)。
Elena - 資料工程師 AI Skill($29):資料管線、結構描述、轉換和資料品質檢查。當任務涉及搬移資料而不是提供資料服務時,就使用它。
文件與流程
Saoirse - 技術寫作者 AI Skill($29):以一致的語氣撰寫 README、PR 說明、變更日誌、架構筆記和入門文件。安裝後要求 Claude Code 「撰寫 PR 說明」,你會得到背景、變更內容、測試和風險,而不只是一句話。
Dorian - AI API 文件代理程式($32):從程式碼產生並維護 API 參考文件:端點、參數、範例和錯誤回應。將它指向路由器檔案,讓它補齊缺漏。
Verity - 發布工程與建置系統工程師 AI Skill($29):版本管理、發布說明、提交訊息規範、建置設定和可重現性。如果你的團隊經常爭論 Conventional Commits,這就是該安裝的 Skill。
安全性
Anaya - 應用程式安全工程師 AI Skill($29):檢查程式碼中的注入問題、驗證缺陷、機密資訊處理方式和相依性風險,並說明修正方法,而不只是指出問題。請在發布前執行,不要等到發布後。
Selwyn - 滲透測試員 Claude Skill($29):像攻擊者一樣檢視你自己的應用程式:威脅模型、攻擊路徑,以及應優先測試項目的清單。
Cassandra - 漏洞管理工程師 Claude Skill($29):對掃描器輸出和 CVE 清單進行分類:哪些值得關注、哪些只是雜訊、哪些應優先修補。搭配 CI 中的相依性稽核一起使用。
不確定該從哪個開始?Claude 技能市集頁面會依角色整理完整目錄,而Claude Code 系列則是其中的開發者子集。
常見問題
Claude Code Skills 資料夾在哪裡?
專案層級的 Skills 位於 .claude/skills/<name>/SKILL.md 在你的儲存庫內。使用者層級的 Skills 位於 ~/.claude/skills/<name>/SKILL.md 在你的家目錄中,並套用至每個專案。
Claude Code Skills 能在 ChatGPT 中運作嗎?
有 .md 檔案會載入,但不會自動探索。你可以將相同的 SKILL.md 貼上或上傳,作為自訂 GPT 的指示,它的行為會一樣。ChatGPT 沒有的是資料夾慣例和基於描述的載入功能,因此你必須使用該 GPT 來呼叫它,而不是由 Claude Code 判斷它是否相關。
Claude Code Skill 和 CLAUDE.md 有什麼不同?
CLAUDE.md 每一輪都會載入,應該放置專案的簡短、永久性資訊。Skill 只有在其描述符合任務時才會載入,長度可以依程序需求而定。冗長的檢查清單應放在 Skills,而不是 CLAUDE.md 中。
可以一次安裝多個 Skill 嗎?
可以。每個 Skill 都是 .claude/skills 下的獨立資料夾,Claude Code 會將它們全部建立索引。由於在需要某個 Skill 之前,只有描述會保留在上下文中,因此安裝 15 個 Skills 在實際觸發其中一個之前,幾乎不會增加負擔。
使用 Skills 需要 MCP 伺服器嗎?
不用。Skills 是指示,並可與 Claude Code 內建工具(檔案編輯、Shell、git)搭配使用。MCP 伺服器會加入資料庫或瀏覽器等外部工具;Skill 可以告訴 Claude 如何善用這些工具,但不要求一定要有它們。
重點是
Claude Code Skill 是一個包含 SKILL.md 的資料夾,放在專案的 .claude/skills,或放在你的 ~/.claude/skills 中。Claude Code 會根據其描述找到它,並只在需要時載入。讓 CLAUDE.md 保持簡短,使用斜線指令執行明確操作,使用 MCP 取得工具,並使用 Skills 提供專業能力。先安裝一個,用三種不同說法和一個負面案例測試,然後依照工作流程需求加入其他 Skills。

瀏覽 KissMySkills 上的Claude Code Skills 集合中的所有開發者 Skills。


