Skills
Skills 是由指令、脚本和资源组成的文件夹,Claude会动态加载它们,以提升在专业任务上的表现。每个Skill的核心是一个SKILL.md文件——一组打包好的指令,您只需上传一次,然后就可以附加到任意messages.create调用中。您在教Claude如何按照您的方式做某件事:您的状态报告格式、您的审查清单、您的发布说明。Claude会读取这个Skill,遵循其中的流程,并产出符合您要求形式的结果。
Skills与工具的区别
有必要把两者的区别讲清楚,因为它们解决的是不同的问题:
- 工具将Claude连接到数据和操作。"查一下这段代码""发送这封邮件"——Claude调用工具,由其他东西来执行。
- Skills教会Claude一套流程。"按照这个模板生成每日状态报告"——这是一份Claude会阅读并遵循的操作手册,有时还意味着它自己运行打包好的脚本。
一个简单的记忆方法:工具关乎Claude能做什么,而Skills关乎您希望它如何做。

还有一点值得了解:Skills在启动时不会完全加载到上下文中。一开始只会加载名称和描述。当您的agent判断某个Skill相关时,才会将完整的Skill加载到上下文中。这样即使有很多Skills可用,也能让您的上下文保持精简。
上传一个Skill
Skills只需上传一次到您的工作区,之后通过ID引用。您可以直接在Claude Platform上上传,也可以通过编程方式完成:
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。以下是状态报告生成器的完整调用:
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里。

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

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