加载中
加载中

Skills

Skills 是由指令、脚本和资源组成的文件夹,Claude会动态加载它们,以提升在专业任务上的表现。每个Skill的核心是一个SKILL.md文件——一组打包好的指令,您只需上传一次,然后就可以附加到任意messages.create调用中。您在教Claude如何按照您的方式做某件事:您的状态报告格式、您的审查清单、您的发布说明。Claude会读取这个Skill,遵循其中的流程,并产出符合您要求形式的结果。

Skills与工具的区别

有必要把两者的区别讲清楚,因为它们解决的是不同的问题:

  • 工具将Claude连接到数据和操作。"查一下这段代码""发送这封邮件"——Claude调用工具,由其他东西来执行。
  • Skills教会Claude一套流程。"按照这个模板生成每日状态报告"——这是一份Claude会阅读并遵循的操作手册,有时还意味着它自己运行打包好的脚本。

一个简单的记忆方法:工具关乎Claude能做什么,而Skills关乎您希望它如何做。

工具与Skills的并排对比:工具连接数据、执行操作并运行代码——即Claude能做什么;Skills仅用指令教授一套流程、不运行代码——即您希望它如何完成

还有一点值得了解:Skills在启动时不会完全加载到上下文中。一开始只会加载名称和描述。当您的agent判断某个Skill相关时,才会将完整的Skill加载到上下文中。这样即使有很多Skills可用,也能让您的上下文保持精简。

上传一个Skill

Skills只需上传一次到您的工作区,之后通过ID引用。您可以直接在Claude Platform上上传,也可以通过编程方式完成:

python
import anthropic
from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

skill = client.skills.create(
    display_name="Status Report Generator",
    files=files_from_dir("status-report-skill"),  # folder containing SKILL.md
)

print(skill.id)  # reference this ID in future requests

在这个例子中,我想要一个状态报告生成器。所有关于什么是好的状态报告的规则——分段、语气、如何总结、如何处理阻塞项——都预先打包在一个Skill中。而活动日志本身只是一个在请求时传入的字符串。

将Skill附加到请求中

Skill通过容器配置附加到请求中——容器内有一个skills数组,其中每一项都指定一个skill_id和version。以下是状态报告生成器的完整调用:

python
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": skill.id,
                "version": "latest",
            }
        ]
    },
    tools=[
        {
            "type": "code_execution_20250825",
            "name": "code_execution",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
        }
    ],
)

有几点值得注意:

  • 我们调用的是标准的client.messages.create,没有带beta header。Skills在Claude API上已经普遍可用,因此不再需要skills-2025-10-02这个beta header;仍然发送该header的请求会继续正常工作,不受影响。
  • container.skills是Skill附加的位置。它是一个列表,因此您可以在一次调用中叠加多个Skills。
  • 这里还启用了代码执行。这是必需的:在API上,Skills运行在代码执行工具的容器内,正是这一点让Skill的流程能够真正执行工作——比如在终端中运行脚本。

运行它

输出结果是一份完全按照Skill规定的格式排版的状态报告。分段、语气、阻塞项处理方式——所有这些都来自您上传的SKILL.md文件。用户提示只有一行;实际流程都在Skill里。

生成的每日状态报告的终端输出,包含"已完成"和"阻塞项"部分,以及由Skill格式化的摘要

在生产应用中,这正是一个团队在整个产品功能范围内统一输出的方式。借助这个每日状态报告端点,每位产品经理得到的都是相同的结构、相同的语气、相同的分段、相同的顺序——而无需任何人把模板复制粘贴进提示中。

一个项目管理应用的"每日报告"页面,每个项目的活动日志旁都有一个由Skill支持的一键"生成报告"按钮

总结回顾

  • Skills将您的流程打包起来。 一个SKILL.md文件(加上任何脚本和资源)教会Claude您希望某件事如何完成。
  • 工具与Skills的区别: 工具关乎Claude能做什么;Skills关乎您希望它如何做。
  • Skills是渐进式加载的。 启动时只加载名称和描述;当agent决定使用某个Skill时,完整的Skill才会加载到上下文中。
  • 使用client.skills.create上传一次,然后在任意messages.create调用中通过container.skills附加——它是一个列表,因此您可以叠加多个Skills。
  • 当Skill的流程需要真正执行工作时,搭配代码执行使用。
  • 当如何做和做什么同样重要时,就考虑使用Skill。