Claude Code 是唯一真正會從磁碟安裝 Skills 的 Claude 介面，因此針對它的建議，和所有關於 Custom Instructions 的內容都不同。這是一份實用指南：資料夾如何運作、什麼樣的 Skills 值得保留，以及人們在哪些地方浪費時間。
Skills 在 Claude Code 中如何運作
Skills 存放在 .claude/skills/ 目錄中。每個 Skill 都是一個子資料夾，裡面包含 SKILL.md。有兩個位置很重要：
-
專案 - 儲存庫內的
.claude/skills/。Skill 會隨著程式碼一起保存，因此團隊中的每個人都能取得。任何專案專用的內容都應放在這裡。 - 個人 - 你主目錄中的相同路徑。適用於你處理的所有工作。這裡應放你自己的習慣。
Custom Instructions 一次只能保存一項內容，而 Claude Code 可以保存許多 Skills，並載入與你目前工作相符的那一個。這改變了優良 Skill 的樣貌：它的描述必須精確到足以選出正確的 Skill，也要足夠狹窄，避免在所有情況下都被選取。
什麼樣的 Skill 真正值得保留
建立過許多這類內容後，可以看出一致的模式。優良的 Skills 編碼的是決策，而不是資訊。
列出 REST API 定義的 Skill，會把 token 浪費在模型已經知道的內容上。相反地，如果 Skill 說：「在這個儲存庫中，每個端點都會以 RFC 7807 格式回傳錯誤，而其中三個例外是舊有程式，絕對不能照抄」，那麼它就值得永久保留，因為這是模型無法自行推斷的決策。
判斷標準是：如果一位能力合格、剛加入團隊的工程師需要有人告訴他這件事，就把它放進 Skill。如果他本來就應該知道，就不要放。
值得建立的類別
採用團隊標準的程式碼審查
通用的審查意見只是噪音。一個包含團隊實際慣例、那些你們曾爭論過並達成共識的事項的審查 Skill，能把審查從意見轉變為檢查清單。
測試慣例
使用哪個框架、測試如何命名、哪些內容要模擬而哪些絕不模擬，以及對這個程式碼庫而言，怎樣才算足夠的涵蓋率。沒有這些規範，你會得到各種以訓練資料中最常見風格撰寫的測試。
除錯與事故處理
日誌在哪裡、哪個儀表板能回答哪個問題、升級處理前要先檢查哪四件事。這是凌晨 3 點就能回本的 Skill。
基礎架構與部署
部署順序、哪些操作可以安全地對正式環境執行而哪些不行，以及哪些遷移需要維護時段。編碼危險部分正是重點。
文件與技術寫作
文件存放在哪裡、頁面採用什麼結構，以及在你們的團隊風格中，教學文章和參考文件有何不同。
應該跳過的內容
語言教學。向 Claude 解釋 Python 語法的 Skill，就像向已經懂 Python 語法的對象解釋 Python 語法。
巨大的包羅萬象型 Skills。一個涵蓋前端、後端、測試和部署的 Skill 會不斷被載入，但每次大多都不相關。請拆開它。
一個月後就會過時的任何內容。版本號碼、目前的衝刺目標、當值人員的姓名。Skills 是用來保存持久性決策的。
模糊的描述。如果描述沒有清楚說明 Skill 何時適用，它要麼永遠不會被選取，要麼總是被選取。兩種情況都沒有用。
從範本開始，而不是從空白頁開始
最難的不是構想，而是形式：要具體到什麼程度、哪些內容應省略，以及如何撰寫描述才能讓選取機制正常運作。這正是值得從已經測試過的內容中複製的部分。
我們為開發人員、DevOps 和架構師發布以角色為基礎的 Skill 檔案，以純 .md 格式撰寫，既可作為 Claude Code Skill 使用，也可貼到 Custom Instructions 中：
Claude Code Skills →
開發人員 Skills →
DevOps Skills →
架構師 Skills →
如果你沒有使用 Claude Code，卻仍然來到這裡，那麼網頁版 Claude 的對應功能是 Custom Instructions。
KissMySkills 是一個獨立市集，與 Anthropic、OpenAI 或任何其他 AI 公司沒有附屬、認可或關聯關係。Claude Code 是 Anthropic 的產品。
