跳转到主要内容

如何创建自定义技能

免费、专业版、最大版、超级版、团队版和企业版计划的用户都可以使用技能。此功能需要启用代码执行。技能也可供 Claude Code 用户和所有使用代码执行工具的 API 用户在测试版中使用。

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

技能可以简单到只有几行说明,也可以复杂到包含可执行代码的多文件包。最好的技能:

  • 解决特定的、可重复的任务

  • 有 Claude 可以遵循的清晰说明

  • 在有帮助时包含示例

  • 定义何时应该使用它们

  • 专注于一个工作流程,而不是试图做所有事情


录制技能

录制技能在 Claude for Mac 的 Cowork 中可用于专业版、最大版、超级版和团队版计划。在聊天、Windows 或免费版和企业版计划中不可用。

您可以不手动编写技能,而是录制自己执行任务的过程,让 Claude 根据观察到的内容构建技能。您向 Claude 发送屏幕、点击、输入和语音的视频,Claude 会提议一个技能供您在保存前审查。

录制前

  1. 更新到最新版本的 Claude for Mac。

  2. 首次录制时,授予 macOS 要求的 Claude 权限:用于鼠标和键盘跟踪的辅助功能,以及用于屏幕可见性的屏幕录制。macOS 可能会要求您重新启动 Claude。

  3. 关闭任何您不想被捕获的文件、应用或对话。

警告:录制时不要输入密码或机密信息,也不要显示敏感信息或私人对话。整个会话期间屏幕上的所有内容都会被捕获,以及您说的任何内容。

录制您的工作流程

  1. 在 Claude for Mac 中打开 Cowork。

  2. 通过以下两种方式之一开始录制:

    1. 点击编辑器中的“+”按钮,然后选择“录制技能。”

    2. 转到自定义 > 技能,点击“添加,”然后选择“录制您的屏幕。”

  3. 点击“开始录制。”要在工作时进行旁白,请保持麦克风打开。使用麦克风控制将其静音或选择不同的输入。

  4. 按照您通常的方式执行任务。捕获栏显示录制正在进行中,并计算它捕获的步骤数。

  5. 完成后点击“完成,”或点击“丢弃”以放弃录制而不创建任何内容。

录制可以运行约 10 分钟。当您还有约一分钟时,捕获栏中会出现倒计时。当倒计时到零时,录制停止,您捕获到该点的所有内容都会发送给 Claude,就像您点击了“完成”一样。

提示:在录制时讲述您正在做的事情。旁白为 Claude 提供了它无法从您的屏幕单独获得的背景信息,例如您为什么跳过某个步骤或如何在两个选项之间进行选择。

点击完成后会发生什么

Claude 启动 Cowork 任务并审查录制,然后提议一个技能。根据它发现的内容,您会看到以下两种情况之一:

  • 一个新技能,在提议卡上标记为新建。点击“保存”以保留它,或点击“关闭”以放弃提议。

  • 对现有技能的更新。如果录制与您已有的技能重叠,Claude 会改为提议对该技能的更改。卡片显示提议所基于的技能。点击“更新”以应用更改,或点击“关闭”以放弃更改。

在提议卡上展开内容以在您决定前阅读技能。

您从录制中保存的技能会出现在自定义 > 技能中,并像任何其他技能一样工作。您可以按相同条款编辑、共享和删除它们。

从录制中保留的内容

您的录制中的视频和音频不会被保留。将录制发送给 Claude 后,Claude 会审查录制以构建技能。之后保存的是会话中的一组屏幕截图,您可以通过展开任务中的录制演示步骤来查看。

由于这些屏幕截图位于 Cowork 任务中,删除任务会删除它们。请参阅Claude Cowork 入门了解任务删除和保留的工作原理。


创建 skill.md 文件

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

必需的元数据字段

name:您的技能的人类友好名称(最多 64 个字符)

  • 示例:品牌指南

description:清晰描述技能的功能和使用时机。

  • 这很关键——Claude 使用它来确定何时调用您的技能(最多 200 个字符)。

  • 示例:将 Acme Corp 品牌指南应用于演示文稿和文档,包括官方颜色、字体和徽标使用。

可选元数据字段

dependencies:您的技能所需的软件包。

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

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

Markdown 正文

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

示例 skill.md

品牌指南技能

## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents

## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.

## Brand Colors

Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography

Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt

## Logo Usage

Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.

## When to Apply

Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients

## Resources

See the resources folder for logo files and font downloads.

添加资源

如果您有太多信息无法添加到单个 skill.md 文件中(例如,仅适用于特定场景的部分),您可以在技能目录中添加文件来添加更多内容。例如,将包含补充和参考信息的 REFERENCE.md 文件添加到您的技能目录中。在 skill.md 中引用它将帮助 Claude 在执行技能时决定是否需要访问该资源。

添加脚本

对于更高级的技能,可以将可执行代码文件附加到 skill.md,允许 Claude 运行代码。例如,我们的文档技能使用以下编程语言和包:

  • Python(pandas、numpy、matplotlib)

  • JavaScript/Node.js

  • 文件编辑辅助包

  • 可视化工具

注意:Claude 和 Claude Code 在加载技能时可以从标准存储库(Python PyPI、JavaScript npm)安装包。使用 API 技能时无法在运行时安装其他包——所有依赖项必须预先安装在容器中。


打包您的技能

技能文件夹完成后:

  1. 确保文件夹名称与您的技能名称匹配。

  2. 创建文件夹的 ZIP 文件。

  3. ZIP 应将技能文件夹作为其根目录(不是子文件夹)。

正确的结构:

my-skill.zip

└── my-skill/

├── skill.md

└── resources/

不正确的结构:

my-skill.zip

└── (文件直接在 ZIP 根目录中)


测试您的技能

上传前

1. 查看您的 skill.md 以确保清晰。

2. 检查描述是否准确反映了 Claude 应该何时使用该技能。

3. 验证所有引用的文件是否存在于正确的位置。

4. 使用示例提示进行测试,以确保 Claude 适当地调用它。

上传到 Claude 后

1. 在 自定义 > 技能 中启用该技能。

2. 尝试几个应该触发它的不同提示。

3. 查看 Claude 的思考过程以确认它正在加载该技能。

4. 如果 Claude 在预期时没有使用它,请迭代描述。

当您在聊天中与 Claude 一起迭代技能时,您可以直接编辑在对话旁边打开的技能文件。突出显示要更改的文本,单击 “使用 Claude 编辑”,然后输入您的请求。对于有多个文件的技能,在文件中留下编辑请求并一起发送,Claude 会在一次通过中应用它们。了解有关 编辑工件 的更多信息。

团队和企业计划说明:要使技能对您组织中的所有用户可用,请参阅 为您的组织配置和管理技能。


最佳实践

保持专注:为不同的工作流创建单独的技能。多个专注的技能比一个大型技能组合得更好。

编写清晰的描述:Claude 使用描述来决定何时调用您的技能。请具体说明何时适用。

从简单开始:在添加复杂脚本之前,先从 Markdown 中的基本说明开始。您可以随时稍后扩展该技能。

使用示例:在您的 skill.md 文件中包含示例输入和输出,以帮助 Claude 理解成功的样子。

增量测试:在每次重大更改后进行测试,而不是一次性构建复杂的技能。

技能可以相互构建:虽然技能不能显式引用其他技能,但 Claude 可以自动一起使用多个技能。这种可组合性是技能功能最强大的部分之一。

查看开放的 Agent Skills 规范:遵循 agentskills.io 上的指南,以便您创建的技能可以在采用该标准的平台上工作。

有关技能创建的更深入指南,请参阅我们 Claude 文档中的 技能编写最佳实践。


安全考虑

  • 在向 skill.md 文件添加脚本时要谨慎。

  • 不要硬编码敏感信息(API 密钥、密码)。

  • 在启用之前查看您下载的任何技能。

  • 使用适当的 MCP 连接来访问外部服务。


参考示例技能

访问我们在 GitHub 上的存储库以获取可用作模板的示例技能:https://github.com/anthropics/skills/tree/main/skills。

这是否解答了您的问题?