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