Skills 适用于 Pro、Max、Team 和 Enterprise 计划的用户。此功能需要启用代码执行。Skills 也可供 Claude Code 用户和所有使用代码执行工具的 API 用户以测试版形式使用。
自定义 Skills 让您可以使用特定于您的组织或个人工作风格的专业知识和工作流程来增强 Claude。本文介绍如何创建、构建和测试您自己的 Skills。
Skills 可以简单到几行指令，也可以复杂到包含可执行代码的多文件包。最好的 Skills：
解决特定的、可重复的任务
有 Claude 可以遵循的清晰指令
在有帮助时包含示例
定义何时应该使用它们
专注于一个工作流程，而不是试图做所有事情
创建 Skill.md 文件
每个 Skill 都包含一个目录，其中至少包含一个 Skill.md 文件，这是 Skill 的核心。此文件必须以 YAML 前置元数据开头，以保存名称和描述字段，这些是必需的元数据。它还可以包含其他元数据、Claude 的说明或参考文件、可执行脚本或工具。
必需的元数据字段
name：您的 Skill 的人类友好名称（最多 64 个字符）
示例：品牌指南
description：Skill 的功能及何时使用的清晰描述。
这很关键——Claude 使用此信息来确定何时调用您的 Skill（最多 200 个字符）。
示例：将 Acme Corp 品牌指南应用于演示文稿和文档，包括官方颜色、字体和徽标使用。
可选元数据字段
dependencies：您的 Skill 所需的软件包。
示例：python>=3.8, pandas>=1.5.0
Skill.md 文件中的元数据充当渐进式披露系统的第一级，提供足够的信息让 Claude 知道何时应该使用 Skill，而无需加载所有内容。
Markdown 正文
Markdown 正文是元数据之后的第二级详细信息，因此如果需要，Claude 在读取元数据后将访问此内容。根据您的任务，Claude 可以访问 Skill.md 文件并使用 Skill。
Skill.md 示例
品牌指南 Skill
## 元数据
name: 品牌指南
description: 将 Acme Corp 品牌指南应用于所有演示文稿和文档
## 概述
此 Skill 提供 Acme Corp 的官方品牌指南，用于创建一致、专业的材料。创建演示文稿、文档或营销材料时，应用这些标准以确保所有输出与 Acme 的视觉识别相匹配。Claude 应在创建外部面向的材料或代表 Acme Corp 的文档时参考这些指南。
## 品牌颜色
我们的官方品牌颜色是：
- 主色：#FF6B35（珊瑚色）
- 辅助色：#004E89（海军蓝）
- 强调色：#F7B801（金色）
- 中性色：#2E2E2E（炭灰色）
## 排版
标题：Montserrat Bold
正文：Open Sans Regular
大小指南：
- H1：32pt
- H2：24pt
- 正文：11pt
## 徽标使用
始终在浅色背景上使用全彩徽标。在深色背景上使用白色徽标。在徽标周围保持最少 0.5 英寸的间距。
## 何时应用
在创建以下内容时应用这些指南：
- PowerPoint 演示文稿
- 用于外部共享的 Word 文档
- 营销材料
- 客户报告
## 资源
请参阅资源文件夹以获取徽标文件和字体下载。
添加资源
如果您有太多信息无法添加到单个 Skill.md 文件中（例如，仅适用于特定场景的部分），您可以通过在 Skill 目录中添加文件来添加更多内容。例如，向 Skill 目录添加包含补充和参考信息的 REFERENCE.md 文件。在 Skill.md 中引用它将帮助 Claude 决定在执行 Skill 时是否需要访问该资源。
添加脚本
对于更高级的 Skills，将可执行代码文件附加到 Skill.md，允许 Claude 运行代码。例如，我们的文档 Skills 使用以下编程语言和包：
Python（pandas、numpy、matplotlib）
JavaScript/Node.js
帮助进行文件编辑的包
可视化工具
注意：Claude 和 Claude Code 可以在加载 Skills 时从标准存储库（Python PyPI、JavaScript npm）安装包。对于 API Skills，无法在运行时安装其他包——所有依赖项必须预先安装在容器中。
打包您的 Skill
Skill 文件夹完成后：
确保文件夹名称与您的 Skill 名称匹配。
创建文件夹的 ZIP 文件。
ZIP 应将 Skill 文件夹作为其根目录（不是子文件夹）。
正确的结构：
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
不正确的结构：
my-Skill.zip
└── （文件直接在 ZIP 根目录中）
测试您的 Skill
上传前
1. 检查您的 Skill.md 的清晰度
2. 检查描述是否准确反映 Claude 何时应该使用 Skill
3. 验证所有引用的文件是否存在于正确的位置
4. 使用示例提示进行测试，以确保 Claude 适当地调用它
上传到 Claude 后
1. 在设置 > 功能中启用 Skill。
2. 尝试几个应该触发它的不同提示
3. 查看 Claude 的思考过程以确认它正在加载 Skill
4. 如果 Claude 在预期时没有使用它，请迭代描述
Team 和 Enterprise 计划的注意事项：要使 Skill 对您组织中的所有用户可用，请参阅为您的组织配置和管理 Skills。
最佳实践
保持专注：为不同的工作流程创建单独的 Skills。多个专注的 Skills 比一个大型 Skill 组合得更好。
编写清晰的描述：Claude 使用描述来决定何时调用您的 Skill。具体说明何时适用。
从简单开始：在添加复杂脚本之前，先从 Markdown 中的基本说明开始。您可以稍后始终扩展 Skill。
使用示例：在您的 Skill.md 文件中包含示例输入和输出，以帮助 Claude 理解成功的样子。
增量测试：在每次重大更改后进行测试，而不是一次性构建复杂的 Skill。
Skills 可以相互构建：虽然 Skills 不能显式引用其他 Skills，但 Claude 可以自动一起使用多个 Skills。这种可组合性是 Skills 功能最强大的部分之一。
查看开放 Agent Skills 规范：遵循 agentskills.io 的指南，以便您创建的 Skills 可以在采用该标准的跨平台上工作。
有关 Skill 创建的更深入指南，请参阅我们 Claude 文档中的 Skill 编写最佳实践。
安全考虑
在向 Skill.md 文件添加脚本时要谨慎。
不要硬编码敏感信息（API 密钥、密码）。
在启用之前查看您下载的任何 Skills。
使用适当的 MCP 连接来访问外部服务。
参考示例 Skills
访问我们在 GitHub 上的存储库以获取可用作模板的示例 Skills：https://github.com/anthropics/skills/tree/main/skills。