Skills 適用於免費、Pro、Max、Team 和 Enterprise 計畫的使用者。此功能需要啟用程式碼執行。Skills 也以測試版形式提供給 Claude Code 使用者和所有使用程式碼執行工具的 API 使用者。
自訂 Skills 可讓您使用特定於您的組織或個人工作風格的專業知識和工作流程來增強 Claude。本文說明如何建立、結構化和測試您自己的 Skills。
Skills 可以簡單到只有幾行指示，也可以複雜到包含可執行程式碼的多檔案套件。最佳的 Skills：
解決特定的、可重複的任務
具有 Claude 可以遵循的清晰指示
在有幫助時包含範例
定義何時應該使用它們
專注於一個工作流程，而不是試圖做所有事情
建立 Skill.md 檔案
每個 Skill 都包含一個目錄，其中至少包含一個 Skill.md 檔案，這是 Skill 的核心。此檔案必須以 YAML 前置資料開始，以保存名稱和描述欄位，這些是必需的中繼資料。它還可以包含其他中繼資料、Claude 的指示或參考檔案、可執行指令碼或工具。
必需的中繼資料欄位
name：您的 Skill 的人類友善名稱（最多 64 個字元）
範例：品牌指南
description：Skill 的功能及何時使用的清晰描述。
這很關鍵——Claude 使用此資訊來判斷何時應該叫用您的 Skill（最多 200 個字元）。
範例：將 Acme Corp 品牌指南應用於簡報和文件，包括官方顏色、字體和標誌使用。
選用的中繼資料欄位
dependencies：您的 Skill 所需的軟體套件。
範例：python>=3.8, pandas>=1.5.0
Skill.md 檔案中的中繼資料用作漸進式揭露系統的第一層，提供足夠的資訊讓 Claude 知道何時應該使用 Skill，而無需載入所有內容。
Markdown 正文
Markdown 正文是中繼資料之後的第二層詳細資訊，因此如果需要，Claude 在讀取中繼資料後將存取此內容。根據您的任務，Claude 可以存取 Skill.md 檔案並使用 Skill。
Skill.md 範例
品牌指南 Skill
## 中繼資料
name: Brand Guidelines
description: 將 Acme Corp 品牌指南應用於所有簡報和文件
## 概述
此 Skill 提供 Acme Corp 的官方品牌指南，用於建立一致、專業的材料。建立簡報、文件或行銷材料時，應用這些標準以確保所有輸出與 Acme 的視覺識別相符。Claude 應在建立外部面向的材料或代表 Acme Corp 的文件時參考這些指南。
## 品牌顏色
我們的官方品牌顏色為：
- 主要：#FF6B35（珊瑚色）
- 次要：#004E89（海軍藍）
- 強調：#F7B801（金色）
- 中性：#2E2E2E（深灰色）
## 排版
標題：Montserrat Bold
正文：Open Sans Regular
大小指南：
- H1：32pt
- H2：24pt
- 正文：11pt
## 標誌使用
始終在淺色背景上使用全彩標誌。在深色背景上使用白色標誌。在標誌周圍保持最少 0.5 英吋的間距。
## 何時應用
建立以下內容時應用這些指南：
- PowerPoint 簡報
- 用於外部共享的 Word 文件
- 行銷材料
- 客戶報告
## 資源
請參閱資源資料夾以取得標誌檔案和字體下載。
新增資源
如果您有太多資訊無法新增到單一 Skill.md 檔案（例如，僅適用於特定情況的部分），您可以透過在 Skill 目錄中新增檔案來新增更多內容。例如，將包含補充和參考資訊的 REFERENCE.md 檔案新增到您的 Skill 目錄。在 Skill.md 中參考它將幫助 Claude 決定執行 Skill 時是否需要存取該資源。
新增指令碼
對於更進階的 Skills，將可執行程式碼檔案附加到 Skill.md，允許 Claude 執行程式碼。例如，我們的文件 Skills 使用以下程式設計語言和套件：
Python（pandas、numpy、matplotlib）
JavaScript/Node.js
幫助進行檔案編輯的套件
視覺化工具
注意：Claude 和 Claude Code 可以在載入 Skills 時從標準儲存庫（Python PyPI、JavaScript npm）安裝套件。使用 API Skills 時無法在執行時安裝其他套件——所有相依性必須預先安裝在容器中。
打包您的 Skill
Skill 資料夾完成後：
確保資料夾名稱與您的 Skill 名稱相符。
建立資料夾的 ZIP 檔案。
ZIP 應將 Skill 資料夾作為其根目錄（不是子資料夾）。
正確的結構：
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
不正確的結構：
my-Skill.zip
└──（檔案直接在 ZIP 根目錄中）
測試您的 Skill
上傳前
1. 檢查您的 Skill.md 是否清晰
2. 確認描述準確反映 Claude 何時應該使用 Skill
3. 驗證所有參考的檔案存在於正確的位置
4. 使用範例提示進行測試，以確保 Claude 適當地叫用它
上傳到 Claude 後
1. 在自訂 > Skills 中啟用 Skill。
2. 嘗試應該觸發它的多個不同提示
3. 檢查 Claude 的思考過程以確認它正在載入 Skill
4. 如果 Claude 在預期時未使用它，請反覆修改描述
Team 和 Enterprise 計畫的注意事項：若要讓組織中的所有使用者都可以使用 Skill，請參閱為您的組織佈建和管理 Skills。
最佳實踐
保持專注：為不同的工作流程建立單獨的 Skills。多個專注的 Skills 比一個大型 Skill 組合得更好。
撰寫清晰的描述：Claude 使用描述來決定何時叫用您的 Skill。請具體說明何時適用。
從簡單開始：在新增複雜指令碼之前，先從 Markdown 中的基本指示開始。您稍後可以隨時擴展 Skill。
使用範例：在您的 Skill.md 檔案中包含範例輸入和輸出，以幫助 Claude 了解成功的樣子。
增量測試：在每次重大變更後進行測試，而不是一次性建立複雜的 Skill。
Skills 可以相互建立：雖然 Skills 無法明確參考其他 Skills，但 Claude 可以自動一起使用多個 Skills。這種可組合性是 Skills 功能最強大的部分之一。
檢查開放代理 Skills 規範：遵循agentskills.io 的指南，以便您建立的 Skills 可以在採用該標準的跨平台上運作。
如需更深入的 Skill 建立指南，請參閱我們 Claude 文件中的Skill 編寫最佳實踐。
安全考量
在將指令碼新增到您的 Skill.md 檔案時要謹慎。
不要硬編碼敏感資訊（API 金鑰、密碼）。
在啟用之前檢查您下載的任何 Skills。
使用適當的 MCP 連線進行外部服務存取。
參考範例 Skills
造訪我們在 GitHub 上的儲存庫，以取得可用作範本的範例 Skills：https://github.com/anthropics/skills/tree/main/skills。