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 目录中添加文件来添加更多内容。例如,添加包含补充和参考信息的 REFERENCE.md 文件到您的 Skill 目录。在 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 应包含
