Claude Skills 完整构建--基础知识

Skill 是一个包含以下内容的文件夹：

• SKILL.md（必须）：带有 YAML frontmatter 的 Markdown 格式指令
• scripts/（可选）：可执行代码（Python、Bash 等）
• references/（可选）：按需加载的文档
• assets/（可选）：输出中使用的模板、字体、图标

Skills 使用三级系统：

• 第一级（YAML frontmatter）：始终加载到 Claude 的系统提示中。提供恰到好处的信息，让 Claude 知道何时应使用每个 Skill，而无需将全部内容加载到上下文中。
• 第二级（SKILL.md 正文）：当 Claude 认为该 Skill 与当前任务相关时加载。包含完整的指令和指导。
• 第三级（链接文件）：打包在 Skill 目录中的附加文件，Claude 可以按需选择浏览和发现。

这种递进式披露在保持专业能力的同时最大限度地减少了 token 消耗。

Claude 可以同时加载多个 Skills。你的 Skill 应能与其他 Skills 协同工作，而不是假设自己是唯一可用的能力。

Skills 在 Claude.ai、Claude Code 和 API 上的工作方式完全相同。创建一次，即可在所有平台使用，无需修改——前提是运行环境支持 Skill 所需的任何依赖项。

💡 在没有 MCP 的情况下构建独立 Skills？跳到「规划与设计」——你随时可以回来查看这部分。

如果你已经有一个可运行的 MCP 服务器，那你已经完成了最难的部分。Skills 是顶层的知识层——捕获你已知的工作流程和最佳实践，让 Claude 能够持续地应用它们。

MCP 提供专业厨房：工具、食材和设备的访问权限。

Skills 提供菜谱：一步步地说明如何创造有价值的成果。

两者结合，让用户无需自己摸索每一个步骤就能完成复杂任务。

没有 Skills：

• 用户连接了你的 MCP，但不知道下一步该做什么
• 支持工单询问"我如何用你的集成做 X"
• 每次对话从零开始
• 因为用户每次提示方式不同，结果不一致
• 用户将问题归咎于你的连接器，而真正的问题是工作流程指导缺失

有了 Skills：

• 预构建的工作流程在需要时自动激活
• 一致、可靠的工具使用
• 每次交互中都嵌入了最佳实践
• 降低了你的集成的学习曲线

• claude-skills-完整构建指南简介
• 第一章：基础知识
• 第二章：规划与设计
• 第三章：测试与迭代
• 第四章：分发与共享
• 第五章：模式与故障排除
• 第六章：资源与参考
• 参考 A：快速检查清单
• 参考 B：YAML Frontmatter