Custom Skills 让你能够用特定于你的组织或个人工作风格的专业知识和工作流程来增强 Claude。本文解释了如何创建、构建和测试你自己的 Skills。
Skills 可以简单到只有几行指令,也可以复杂到包含可执行代码的多文件包。最好的 Skills:
解决特定的、可重复的任务
有 Claude 能够遵循的清晰指令
在有帮助时包含示例
定义何时应该使用它们
专注于一个工作流程,而不是试图做所有事情
创建 Skill.md 文件
每个 Skill 都包含一个目录,其中至少包含一个 Skill.md 文件,这是 Skill 的核心。该文件必须以 YAML 前置元数据开头,以保存名称和描述字段,这些是必需的元数据。它还可以包含其他元数据、Claude 的指令或参考文件、可执行脚本或工具。
必需的元数据字段
name: 你的 Skill 的人类友好名称(最多 64 个字符)
示例:品牌指南
description: 对 Skill 的功能和使用时机的清晰描述。
这很关键——Claude 使用这个来确定何时调用你的 Skill(最多 200 个字符)。
示例:将 Acme Corp 品牌指南应用于演示文稿和文档,包括官方颜色、字体和徽标使用。
可选元数据字段
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 示例
品牌指南 Skill
## 元数据
name: 品牌指南
description: 将 Acme Corp 品牌指南应用于所有演示文稿和文档
version: 1.0.0
## 概述
此 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 应该包含 Skill 文件夹作为其根目录(不是子文件夹)
正确的结构:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
不正确的结构:
my-Skill.zip
└── (文件直接在 ZIP 根目录中)
