Skill Creator：Anthropic 官方 Claude Skill 创建完全指南

本文介绍 Anthropic 官方 Skill Creator 指南，详细讲解如何创建有效的 Claude Skill，帮助你将 Claude 从通用助手转变为特定领域的专业代理。

什么是 Skills

Skills 是模块化的自包含包，通过提供专业领域知识、工作流和工具来扩展 Claude 的能力。你可以将它们视为特定领域或任务的"入职指南"——它们将 Claude 从通用代理转变为具备程序性知识的专业代理。

Skills 提供的价值

• 专业工作流：特定领域的多步骤程序
• 工具集成：处理特定文件格式或 API 的指令
• 领域专业知识：公司特定知识、架构、业务逻辑
• 捆绑资源：用于复杂和重复任务的脚本、参考资料和资产

Skill 的解剖结构

每个 Skill 由一个必需的 SKILL.md 文件和可选的捆绑资源组成：

skill-name/
├── SKILL.md (必需)
│   ├── YAML frontmatter 元数据 (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown 指令 (必需)
└── 捆绑资源 (可选)
    ├── scripts/ - 可执行代码 (Python/Bash/等)
    ├── references/ - 按需加载到上下文的文档
    └── assets/ - 用于输出的文件 (模板、图标、字体等)

SKILL.md (必需)

元数据质量：SKILL.md 中的 name 和 description 决定 Claude 何时使用该 Skill。请具体说明 Skill 的功能和使用时机。使用第三人称（例如"当...时应使用此 Skill"而非"当...时使用此 Skill"）。

捆绑资源 (可选)

Scripts (scripts/)

可执行代码（Python/Bash 等），用于需要确定性可靠性或反复重写的任务。

• 何时包含：当相同代码被反复重写或需要确定性可靠性时
• 示例：scripts/rotate_pdf.py 用于 PDF 旋转任务
• 优势：Token 高效、确定性、可在不加载到上下文的情况下执行

References (references/)

旨在按需加载到上下文以指导 Claude 流程和思考的文档和参考资料。

• 何时包含：用于 Claude 工作时需要参考的文档
• 示例：references/finance.md 用于财务架构，references/mnda.md 用于公司 NDA 模板
• 用例：数据库架构、API 文档、领域知识、公司政策、详细工作流指南
• 最佳实践：如果文件较大（>10k 字），在 SKILL.md 中包含 grep 搜索模式

Assets (assets/)

不打算加载到上下文中，而是在 Claude 产生的输出中使用的文件。

• 何时包含：当 Skill 需要在最终输出中使用的文件时
• 示例：assets/logo.png 用于品牌资产，assets/slides.pptx 用于 PowerPoint 模板
• 用例：模板、图像、图标、样板代码、字体、被复制或修改的示例文档

渐进式披露设计原则

Skills 使用三级加载系统来高效管理上下文：

*无限制，因为脚本可以在不读取到上下文窗口的情况下执行。

Skill 创建流程

步骤 1：用具体例子理解 Skill

跳过此步骤仅当 Skill 的使用模式已经清楚理解时。即使使用现有 Skill，这一步也很有价值。

要创建有效的 Skill，清楚理解 Skill 将如何使用的具体例子。这种理解可以来自直接的用户示例或经过用户反馈验证的生成示例。

步骤 2：规划可复用的 Skill 内容

将具体示例转化为有效 Skill，通过分析每个示例：

• 考虑如何从头开始执行示例
• 确定哪些脚本、参考资料和资产在重复执行这些工作流时会有帮助

步骤 3：初始化 Skill

此时，是时候实际创建 Skill 了。仅当正在开发的 Skill 已存在且需要迭代或打包时跳过此步骤。

创建新 Skill 时，始终运行 init_skill.py 脚本：

scripts/init_skill.py <skill-name> --path <output-directory>

该脚本会：

• 在指定路径创建 Skill 目录
• 生成带有正确 frontmatter 和 TODO 占位符的 SKILL.md 模板
• 创建示例资源目录：scripts/、references/ 和 assets/
• 在每个目录中添加可自定义或删除的示例文件

步骤 4：编辑 Skill

编辑 Skill 时，请记住 Skill 是为另一个 Claude 实例创建的。专注于包含对 Claude 有益且非明显的信息。考虑哪些程序性知识、领域特定细节或可重用资产可以帮助另一个 Claude 实例更有效地执行这些任务。

从可复用的 Skill 内容开始

从上面识别的可重用资源开始实现：scripts/、references/ 和 assets/ 文件。

更新 SKILL.md

写作风格：使用祈使/不定式形式（动词优先的指令），而非第二人称。使用客观、指导性的语言（例如"要完成 X，执行 Y"而非"你应该做 X"或"如果你需要做 X"）。这保持了对 AI 消费的一致性和清晰度。

完成 SKILL.md 时回答以下问题：

• Skill 的目的是什么，用几句话说明？
• 何时应该使用该 Skill？
• 在实践中，Claude 应该如何使用该 Skill？

步骤 5：打包 Skill

Skill 准备好后，应打包成可分发的 zip 文件：

scripts/package_skill.py <path/to/skill-folder>

打包脚本将：

• 验证 Skill 自动检查：YAML frontmatter 格式和必填字段、Skill 命名约定和目录结构、描述完整性和质量、文件组织和资源引用
• 打包 Skill（如果验证通过），创建以 Skill 命名的 zip 文件

步骤 6：迭代

测试 Skill 后，用户可能会要求改进。通常这发生在使用 Skill 之后，对 Skill 表现有新鲜记忆时。

迭代工作流：

1. 在真实任务上使用 Skill
2. 注意到困难或低效之处
3. 确定应如何更新 SKILL.md 或捆绑资源
4. 实施更改并再次测试

在不同平台使用 Skills

在 Claude.ai 中使用 Skills

1. 导航到 Settings > Capabilities
2. 确保启用了 Code execution and file creation
3. 滚动到 Skills 部分
4. 在 Skills 部分点击 "Upload skill"
5. 上传你的 ZIP 文件
6. 你的 Skill 将出现在 Skills 列表中，可以切换开启或关闭

在 Claude Code 中使用 Skills

Claude Code 原生支持 Skills，可以通过命令行直接加载和使用。

在 API 中使用 Skills

通过 Anthropic API 调用时可以在请求中包含 Skill。

在 SDK 中使用 Skills

Anthropic SDK 提供了使用 Skills 的编程接口。

总结

Skill Creator 是 Anthropic 官方提供的 Skill 创建指南，通过系统化的六步流程帮助开发者创建高质量的 Claude Skills。遵循渐进式披露设计原则，合理组织 Skill 结构，可以显著提升 Claude 在特定领域的专业能力。