技能適用於免費、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 範例
品牌指南技能
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
新增資源
如果您有太多資訊無法新增至單一 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。