如何创建自定义 Claude Skills
2025/10/19

如何创建自定义 Claude Skills

Skills 通过为 Claude 提供专业知识和工作流程来扩展其能力。

如何创建自定义 Claude Skills

自定义 Skills 让您能够使用特定于您的组织或个人工作风格的专业知识和工作流程来增强 Claude。本文介绍如何创建、构建和测试您自己的 Skills。

Skills 可以简单到几行指令,也可以复杂到包含可执行代码的多文件包。最好的 Skills:

  • 解决特定的、可重复的任务
  • 有 Claude 可以遵循的清晰指令
  • 在有帮助时包含示例
  • 定义何时应该使用它们
  • 专注于一个工作流程,而不是试图做所有事情

创建 Skill.md 文件

每个 Skill 都由一个目录组成,至少包含一个 Skill.md 文件,这是 Skill 的核心。此文件必须以 YAML 前置元数据开头,以保存名称和描述字段,这些是必需的元数据。它还可以包含其他元数据、Claude 的指令或参考文件、可执行脚本或工具。

必需的元数据字段

name:
Skill 的友好名称(最多 64 个字符)

  • 示例:品牌指南

description:
清晰描述 Skill 的作用以及何时使用它。

  • 这很关键——Claude 使用此描述来决定何时调用您的 Skill(最多 200 个字符)。
  • 示例:将 Acme 公司的品牌指南应用于演示文稿和文档,包括官方颜色、字体和徽标使用。

可选元数据字段

version:
在迭代时跟踪 Skill 的版本。

  • 示例:1.0.0

dependencies:
Skill 所需的软件包。

  • 示例:python>=3.8, pandas>=1.5.0

Skill.md 文件中的元数据作为渐进式披露系统的第一层,提供足够的信息让 Claude 知道何时应该使用 Skill,而无需加载所有内容。

Markdown 主体

Markdown 主体是元数据之后的第二层详细信息,因此如果在阅读元数据后需要,Claude 将访问此内容。根据您的任务,Claude 可以访问 Skill.md 文件并使用该 Skill。

示例 Skill.md

访问我们在 GitHub 上的仓库,查看可用作模板的示例 Skills:https://github.com/anthropics/skills。

邮件列表

加入我们的社区

订阅邮件列表,及时获取最新消息和更新