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官方指南的承諾。