技能

"Skills"（技能）是可复用的、基于文件系统的资源，可为您的智能体提供特定领域的专业知识：工作流、上下文和最佳实践，将通用智能体转变为专家。与提示（针对一次性任务的对话级指令）不同，技能按需加载，仅在需要时才会影响上下文窗口。

您可以附加两种类型的技能。两者的工作方式相同：当技能与任务相关时，您的智能体会自动调用它们。

• **Anthropic 预构建技能：**常见的文档任务，例如 PowerPoint、Excel、Word 和 PDF 处理（pptx、xlsx、docx、pdf）。
• **自定义技能：**您自行编写并上传到工作区的技能。

要了解如何编写自定义技能，请参阅 Agent Skills 和技能编写最佳实践。要将自定义技能上传到您的工作区，请参阅创建自定义技能。



创建自定义技能

自定义技能是一个包含 SKILL.md 文件及任何支持文件的目录，以 zip 压缩包或单个文件的形式上传到您的工作区。创建技能后会返回 skill_* ID，您在将其附加到智能体时需要引用该 ID。Anthropic 预构建技能已在每个工作区中可用，无需执行此步骤。如果仅使用预构建技能，请直接跳至将技能附加到智能体。

当您使用 cURL 或 CLI 直接调用 Skills API 时，请显式传递 anthropic-beta: skills-2025-10-02 标头。SDK 会自动发送该标头。

以下示例省略了可选的 display_title 字段，因此技能的标题将从 SKILL.md 中派生。显式传递的 display_title 在您工作区的自定义技能中必须是唯一的。

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

要列出、检索、删除自定义技能以及管理其版本，请参阅管理自定义技能。有关完整的请求和响应架构，请参阅 Create Skill API 参考。技能包直接上传到 Skills API，而不是通过 Files API。



将技能附加到智能体

在创建智能体时附加技能。每个会话最多支持 20 个技能，该数量按会话中所有智能体的技能总数计算（请参阅多智能体会话）。

skills 数组中的每个条目使用以下字段：

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



后续步骤