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