Agent Skills

為什麼要使用 Skills

Skills 是可重複使用、以檔案系統為基礎的資源，能賦予 Claude 特定領域的專業知識：工作流程、上下文與最佳實務，將通用型代理轉變為專家。與提示（針對一次性任務的對話層級指令）不同，Skills 會依需求載入，因此您不必在不同對話中重複相同的指引。

主要優點：

• 讓 Claude 專業化： 針對特定領域的任務量身打造能力
• 減少重複： 建立一次，自動使用
• 組合能力： 結合多個 Skills 以處理複雜的多步驟任務

使用 Skills

Anthropic 為常見的文件任務（PowerPoint、Excel、Word、PDF）提供預先建置的 Agent Skills，您也可以建立自己的自訂 Skills。兩者的運作方式相同：一旦某個 Skill 在您的環境中可用，Claude 就會在與您的請求相關時自動使用它。

預先建置的 Agent Skills 可在 claude.ai、Claude API、Claude Platform on AWS 以及 Microsoft Foundry 上使用。在 Microsoft Foundry 上，Agent Skills 需要託管於 Anthropic 的部署。完整清單請參閱可用的 Skills。

自訂 Skills 讓您能封裝領域專業知識與組織知識。它們可在 Claude 的各項產品中使用：在 Claude Code 中建立、透過 Claude API 上傳，或在 claude.ai 設定中新增。在 Claude Platform on AWS 與 Microsoft Foundry 上，請透過 Skills API 上傳自訂 Skills。

Skills 的運作方式

Skills 利用 Claude 的 VM 環境，提供僅靠提示無法達成的能力。Claude 在具有檔案系統存取權的虛擬機器中運作，使 Skills 能以目錄的形式存在，其中包含指令、可執行程式碼與參考資料，組織方式就像您為新進團隊成員準備的入職指南。

這種基於檔案系統的架構實現了 「progressive disclosure」（漸進式揭露）： Claude 會依需要分階段載入資訊，而非預先耗用上下文。

Skills 可包含三種類型的內容，各自在不同時間載入：

第 1 層：中繼資料（始終載入）

Skill 的 YAML frontmatter 提供探索資訊：

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude 會在啟動時載入這些中繼資料，並將其納入「system prompt」（系統提示）中。description 是 Claude 在判斷是否觸發該 Skill 時用來比對您請求的依據，因此它必須同時說明該 Skill 的功能以及何時使用。這種輕量化的做法意味著您可以安裝許多 Skills 而不會造成上下文負擔：在 Skill 被觸發之前，只有其名稱與描述會佔用上下文。

第 2 層：指令（觸發時載入）

SKILL.md 的主體包含程序性知識：工作流程、最佳實務與指引：

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

當您提出的請求符合某個 Skill 的描述時，Claude 會使用 bash 從檔案系統讀取 SKILL.md。只有在此時，這些內容才會進入上下文視窗。

第 3 層：資源和程式碼（依需要載入）

Skills 可以附帶額外的資料：

• pdf-processing/
  • SKILL.md（主要指示）
  • FORMS.md（表單填寫指南）
  • REFERENCE.md（詳細的 API 參考）
  • scripts/
    • fill_form.py（公用程式腳本）

指示： 額外的 Markdown 檔案（FORMS.md、REFERENCE.md），包含專門的指引與工作流程

程式碼： Claude 透過 bash 執行的可執行腳本（fill_form.py、validate.py），提供確定性的操作，而無需將其程式碼載入上下文

資源： 參考資料，例如資料庫結構描述、API 文件、範本或範例

Claude 只有在被引用時才會存取這些檔案。檔案系統模型意味著每種內容類型各有不同的優勢：指示提供彈性的指引，程式碼提供可靠性，資源則用於查詢事實。

漸進式揭露確保在任何時候只有相關內容會佔用上下文視窗。

Skills 架構

Skills 在程式碼執行環境中運作，Claude 在其中擁有檔案系統存取權、bash 命令和程式碼執行能力。Skills 以目錄的形式存在於虛擬機器上，Claude 使用與您在電腦上瀏覽檔案時相同的 bash 命令與它們互動。

Claude 如何存取 Skill 內容：

當 Skill 被觸發時，Claude 會使用 bash 從檔案系統讀取 SKILL.md，將其指示帶入上下文視窗。如果這些指示參照其他檔案（例如 FORMS.md 或資料庫結構描述），Claude 也會透過額外的 bash 命令讀取這些檔案。當指示提到可執行腳本時，Claude 會透過 bash 執行它們，且只接收輸出（腳本程式碼本身永遠不會進入上下文）。

此架構所帶來的可能性：

• 隨需存取檔案： Claude 只會讀取每個任務所需的檔案。一個 Skill 可以包含數十個參考檔案，但如果您的任務只需要銷售結構描述，Claude 就只會載入那一個檔案。其餘檔案保留在檔案系統中，不耗用任何 token。
• 高效的腳本執行： 當 Claude 執行 validate_form.py 時，腳本的程式碼永遠不會載入上下文視窗。只有其輸出（例如「Validation passed」或特定的錯誤訊息）會耗用 token，這使得腳本遠比讓 Claude 在任務中生成同等程式碼更有效率。
• 隨附內容實際上沒有限制： 檔案在被存取之前不會耗用上下文，因此 Skills 可以包含完整的 API 文件、大型資料集或大量範例。未被使用的隨附內容不會造成任何上下文負擔。

範例：載入 PDF 處理 Skill

以下說明 Claude 如何載入並使用前面範例中的自訂 pdf-processing Skill（而非預建的 pdf Skill）：

1. 啟動： 系統提示包含：pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
2. 使用者請求：「擷取此 PDF 的文字並加以摘要。」
3. Claude 呼叫： bash: cat pdf-processing/SKILL.md → 指示載入上下文。
4. Claude 判斷： 不需要填寫表單，因此 Claude 不會讀取 FORMS.md。
5. Claude 完成任務： 使用 SKILL.md 中的指示。

Skills 的適用範圍

Skills 可在 Claude 的各項代理產品中使用：

Claude API

Claude API 同時支援預建 Agent Skills 和自訂 Skills。兩者的運作方式完全相同：在 container 參數中指定相關的 skill_id，並搭配程式碼執行工具使用。

先決條件： 透過 API 使用 Skills 需要程式碼執行工具，Skills 會在其容器中執行。

透過引用 skill_id（pptx、xlsx、docx 或 pdf）來使用預建 Agent Skills，或透過 Skills API（/v1/skills 端點）建立並上傳您自己的 Skills。自訂 Skills 在整個工作區內共享：所有工作區成員都可以存取它們。

API 上的 Skills 在沙箱容器中執行，沒有網路存取權，也無法在執行時安裝套件。詳情請參閱限制與約束。

如需進一步了解，請參閱透過 API 使用 Agent Skills。

Claude Code

Claude Code 支援自訂 Skills。預建的文件 Skills（PowerPoint、Excel、Word、PDF）在 Claude Code 中無法使用，不過開源的 Claude API 技能已隨附其中。請參閱 Claude Code 隨附的內建命令和 Skills 完整清單。

自訂 Skills： 將 Skills 建立為包含 SKILL.md 檔案的目錄。Claude 會自動探索並使用它們。

Claude Code 中的自訂 Skills 以檔案系統為基礎，不需要透過 API 上傳：將它們放在 ~/.claude/skills/（個人）或 .claude/skills/（專案）中。

如需進一步了解，請參閱在 Claude Code 中使用 Skills。

claude.ai

claude.ai 同時支援預建 Agent Skills 和自訂 Skills。

預建 Agent Skills： 這些 Skills 在您建立文件時會啟用。Claude 會直接使用它們，無需任何設定。

自訂 Skills： 以 zip 檔案上傳您自己的 Skills。適用於 Pro、Max、Ultra、Team 和 Enterprise 方案，且需啟用程式碼執行。

如需進一步了解如何在 claude.ai 中使用 Skills，請參閱 Claude 說明中心的以下資源：

• 什麼是 Skills？
• 在 Claude 中使用 Skills
• 如何建立自訂 Skills
• 使用 Skills 教導 Claude 您的工作方式

Skill 結構

每個 Skill 都需要一個帶有 YAML frontmatter 的 SKILL.md 檔案：

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

必要欄位： name 與 description

欄位要求：

name：

• 最多 64 個字元
• 只能包含小寫字母、數字與連字號
• 不得包含 XML 標籤
• 不得包含保留字：anthropic、claude

description：

• 不得為空
• 最多 1,024 個字元
• 不得包含 XML 標籤

description 必須同時包含該 Skill 的功能以及 Claude 應在何時使用它。完整的撰寫指引請參閱 Skill 撰寫最佳實務。

安全性考量

請只使用來自可信來源的 Skills：您自己建立的，或從 Anthropic 取得的。Skills 透過指示與程式碼賦予 Claude 新的能力，這也意味著惡意的 Skill 可能會指示 Claude 以不符合該 Skill 所宣稱用途的方式呼叫工具或執行程式碼。

主要安全性考量：

• 徹底稽核： 檢閱 Skill 中隨附的所有檔案：SKILL.md、腳本、圖片及其他資源。留意異常模式，例如非預期的網路呼叫、檔案存取模式，或不符合該 Skill 所宣稱用途的操作。
• 外部來源具有風險： 從外部 URL 擷取資料的 Skills 特別具有風險，因為擷取的內容可能包含惡意指示。即使是值得信任的 Skills，若其外部相依項目隨時間變更，也可能遭到入侵。
• 工具濫用： 惡意的 Skills 可能以有害的方式呼叫工具（檔案操作、bash 命令、程式碼執行）。
• 資料暴露： 可存取敏感資料的 Skills 可能被設計成將資訊洩漏至外部系統。
• 比照安裝軟體看待： 將 Skills 整合到可存取敏感資料或關鍵操作的正式環境系統時，請格外小心。

如需組織規模的治理、審核與部署指引，請參閱企業適用的 Skills。Claude Enterprise 組織也可以針對在 claude.ai 與 Claude Cowork 中上傳的自訂 Skills 開啟 Skill 內容掃描。掃描不涵蓋透過 Skills API 或 Claude Console 上傳的 Skills。

可用的 Skills

預先建置的 Agent Skills

下列預先建置的 Agent Skills 可立即使用：

• PowerPoint (pptx)： 建立簡報、編輯投影片、分析簡報內容
• Excel (xlsx)： 建立試算表、分析資料、產生含圖表的報告
• Word (docx)： 建立文件、編輯內容、格式化文字
• PDF (pdf)： 產生格式化的 PDF 文件與報告

這些 Skills 可在 Claude API、Claude Platform on AWS、Microsoft Foundry 與 claude.ai 上使用。請參閱快速入門教學，開始在 API 中使用它們。

開源 Skills

Anthropic 也在 skills 儲存庫中發布開源 Skills：

• Claude API 技能： 為 Claude 提供最新的 API 參考資料、SDK 文件，以及八種程式語言的最佳實務。隨附於 Claude Code，也可從 skills 儲存庫安裝。

自訂 Skills 範例

如需自訂 Skills 的完整範例，請參閱 Agent Skills Cookbook。

資料保留

Agent Skills 不在 ZDR 安排的涵蓋範圍內。Skill 定義與執行資料會依據 Anthropic 的標準資料保留政策保留。

如需 Skills API 操作的稽核記錄，請參閱「透過 API 使用 Agent Skills」中的稽核記錄。

限制與約束

在以下各小節中，Claude Platform on AWS 和 Microsoft Foundry 遵循與 Claude API 相同的限制。此外，在 Microsoft Foundry 上，無法使用 Skill 版本下載端點可檢視預覽，內含 API 參考文件連結——按 Tab 鍵直到焦點進入卡片，按 Escape 鍵返回。（GET /v1/skills/{skill_id}/versions/{version}/content）。

跨介面可用性

自訂 Skills 不會跨介面同步。上傳至某一介面的 Skills 不會自動在其他介面上可用：

• 上傳至 claude.ai 的 Skills 必須另外上傳至 API。
• 透過 API 上傳的 Skills 無法在 claude.ai 上使用。
• Claude Code Skills 是基於檔案系統的，與 claude.ai 及 API 皆互相獨立。

請針對您想使用 Skills 的每個介面分別管理與上傳。

共享範圍

Skills 依您使用的位置而有不同的共享模式：

• Claude API： 整個工作區。所有工作區成員皆可存取已上傳的 Skills。
• Claude Code： 個人（~/.claude/skills/）或以專案為基礎（.claude/skills/）。也可透過 Claude Code 外掛程式共享。

執行階段環境約束

您的 Skill 可用的確切執行階段環境取決於您使用它的產品介面。

• claude.ai：
  • 網路存取程度不一： 視使用者/管理員設定而定，Skills 可能擁有完整、部分或無網路存取權限。如需更多詳細資訊，請參閱使用 Claude 建立與編輯檔案支援文章。
• Claude API：
  • 無網路存取： Skills 無法進行外部 API 呼叫或存取網際網路。
  • 無法在執行階段安裝套件： 只能使用預先安裝的套件。您無法在執行期間安裝新套件。
  • 僅限預先設定的相依項目： 請查看程式碼執行工具文件以取得可用套件清單。
• Claude Code：
  • 完整網路存取： Skills 擁有與使用者電腦上任何其他程式相同的網路存取權限。
  • 不建議全域安裝套件： Skills 應只在本機安裝套件，以避免干擾使用者的電腦。

請規劃您的 Skills，使其能在這些約束下運作。

後續步驟

可用性

Agent Skills在所有模型上可供使用。

API 支援