技能

「Skills」（技能）是可重複使用、基於檔案系統的資源，可為您的代理提供特定領域的專業知識：工作流程、上下文和最佳實踐，將通用代理轉變為專家。與提示（針對一次性任務的對話層級指令）不同，技能會按需載入，僅在需要時才影響上下文視窗。

您可以附加兩種類型的技能。兩者的運作方式相同：當技能與任務相關時，您的代理會自動調用它們。

• **Anthropic 預建技能：**常見的文件任務，例如 PowerPoint、Excel、Word 和 PDF 處理（pptx、xlsx、docx、pdf）。
• **自訂技能：**您自行編寫並上傳至工作區的技能。

若要了解如何編寫自訂技能，請參閱代理技能和技能編寫最佳實踐。若要將自訂技能上傳至您的工作區，請參閱建立自訂技能。



建立自訂技能

自訂技能是一個包含 SKILL.md 檔案及任何支援檔案的目錄，以 zip 封存檔或個別檔案的形式上傳至您的工作區。建立技能後會回傳 skill_* ID，您在將其附加至代理時會參照此 ID。Anthropic 預建技能已在每個工作區中可用，不需要此步驟。若僅使用預建技能，請跳至將技能附加至代理。

當您直接使用 cURL 或 CLI 呼叫 Skills API 時，請明確傳遞 anthropic-beta: skills-2025-10-02 標頭。SDK 會自動傳送此標頭。

這些範例省略了選用的 display_title 欄位，因此技能的標題會從 SKILL.md 衍生。明確傳遞的 display_title 在您工作區的自訂技能中必須是唯一的。

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

若要列出、擷取、刪除自訂技能及管理其版本，請參閱管理自訂技能。如需完整的請求和回應結構描述，請參閱 Create Skill API 參考。技能套件會直接上傳至 Skills API，而非透過 Files API。



將技能附加至代理

在建立代理時附加技能。每個工作階段總共最多支援 20 個技能，此數量計算涵蓋工作階段中的每個代理（請參閱多代理工作階段）。

skills 陣列中的每個項目使用以下欄位：

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



後續步驟