Anthropic Claude技能構建完全指南

Anthropic釋出了關於Claude Skills構建的完整指南，該技能系統於2025年10月推出，迅速成為在Claude Code、Claude Desktop和API中賦予Claude領域特定能力的主要方式。官方技能倉庫（github.com/anthropics/skills）截至2026年5月已獲得超過14.1萬顆星和1.6萬個分支。

技能的本質

一個技能本質上是一個資料夾，其中必須包含一個SKILL.md檔案，並可選擇包含scripts/（可執行程式碼）、references/（參考文件）和assets/（模板等支援檔案）子資料夾。技能不是模型或外掛，而是開源的Markdown指令加支援檔案。其強大之處在於三層漸進式資訊披露架構：YAML前置後設資料（約100令牌，用於判斷相關性）、SKILL.md主體（包含完整指令和工作流）、以及按需載入的引用檔案。這使得使用者可以安裝多個技能而不會過度佔用上下文。

設計原則包括：漸進式資訊披露、可組合性（多個技能可同時載入）和可移植性（技能在Claude.ai、Claude Code和API上一致執行）。在與MCP伺服器的配合中，MCP提供工具連線（"廚房"），而技能提供工作流程（"菜譜"）。

規劃技能

最常見的錯誤是直接開始編寫檔案結構而非先定義用例。一個良好的用例需回答四個問題：使用者想要完成什麼？需要什麼多步工作流？需要哪些工具？應嵌入哪些領域知識？Anthropic觀察到三大類技能：文件和資產建立、工作流自動化、MCP增強。在編寫任何內容前，應定義成功標準，包括定量指標（如90%以上的觸發率）和定性指標（如無需中途糾正）。

技術要求

技能檔案結構嚴格：資料夾名必須是kebab-case，SKILL.md檔名精確大小寫。資料夾內不得有README.md，技能名不得包含"claude"或"anthropic"，前置後設資料中不得使用XML尖括號。YAML前置後設資料至少包含name和description欄位，description需描述功能及觸發條件，不超過1024字元。可選欄位包括license、compatibility和metadata（如author、version、mcp-server）。

編寫有效的技能

描述欄位的可靠公式為：[功能] + [觸發條件] + [關鍵能力]。示例包括分析Figma檔案生成開發文件、管理Linear專案工作流、以及端到端客戶入職流程。良好的描述應包含具體的任務、觸發短語和檔案型別。技能主體應包含步驟指令、示例和故障排除指南。

透過遵循這些原則，使用者可以在一次會話中構建出可工作的技能，這正是Anthropic官方指南的承諾。