跳转到主要内容

如何创建自定义技能

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

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

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

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

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

  • 在有帮助时包含示例

  • 定义何时应该使用它们

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

录制技能

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

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

录制前

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

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

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

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

录制您的工作流程

  1. 打开 Mac 版 Claude 中的 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 使用描述来决定何时调用您的技能。请具体说明何时适用。

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

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

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

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

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

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

安全考虑

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

  • 不要硬编码敏感信息（API 密钥、密码）。

  • 在启用下载的技能之前，请先审查它们。

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

参考示例技能

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

相关文章
这是否解答了您的问题？