技能适用于免费、Pro、Max、Team 和 Enterprise 计划的用户。此功能需要启用代码执行。技能也以测试版形式提供给 Claude Code 用户和所有使用代码执行工具的 API 用户。
自定义技能让您可以使用特定于您的组织或个人工作风格的专业知识和工作流程来增强 Claude。本文介绍如何创建、构建和测试您自己的技能。
技能可以简单到只有几行说明，也可以复杂到包含可执行代码的多文件包。最好的技能：
解决特定的、可重复的任务
具有 Claude 可以遵循的清晰说明
在有帮助时包含示例
定义何时应该使用它们
专注于一个工作流程，而不是试图做所有事情
创建 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 技能无法在运行时安装其他包——所有依赖项必须预先安装在容器中。
打包您的技能
技能文件夹完成后：
确保文件夹名称与您的技能名称匹配。
创建文件夹的 ZIP 文件。
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 在预期时没有使用它，请迭代描述。
Team 和 Enterprise 计划的注意事项：要使技能对您组织中的所有用户可用，请参阅为您的组织配置和管理技能。
最佳实践
保持专注：为不同的工作流程创建单独的技能。多个专注的技能比一个大型技能组合得更好。
编写清晰的描述：Claude 使用描述来决定何时调用您的技能。请具体说明何时适用。
从简单开始：在添加复杂脚本之前，先从 Markdown 中的基本说明开始。您可以随时稍后扩展该技能。
使用示例：在您的 skill.md 文件中包含示例输入和输出，以帮助 Claude 理解成功的样子。
增量测试：在每次重大更改后进行测试，而不是一次性构建复杂的技能。
技能可以相互构建：虽然技能不能显式引用其他技能，但 Claude 可以自动一起使用多个技能。这种可组合性是技能功能最强大的部分之一。
查看开放代理技能规范：遵循agentskills.io上的指南，以便您创建的技能可以在采用该标准的平台上工作。
有关技能创建的更深入指南，请参阅我们 Claude 文档中的技能创作最佳实践。
安全考虑
向您的 skill.md 文件添加脚本时要谨慎。
不要硬编码敏感信息（API 密钥、密码）。
在启用之前查看您下载的任何技能。
使用适当的 MCP 连接来访问外部服务。
参考示例技能
访问我们在 GitHub 上的存储库，获取可用作模板的示例技能：https://github.com/anthropics/skills/tree/main/skills。