Oleksandr Moccogni AI 课程 加入候补名单

Claude Skills是什么:它是什么,哪些工作值得做成技能,风险在哪里

发布于 阅读约 34 分钟
简而言之

Claude Skills是一个个装着指令的文件夹,只有任务需要时Claude才会加载。本文讲清哪些工作值得做成技能,它和连接器有什么区别,以及风险在哪里。

Claude Skills是什么:它是什么,哪些工作值得做成技能,风险在哪里

Claude Skills(技能)是一个个装着指令的文件夹,只有任务需要时Claude才会打开。每个文件夹里有一个写着操作流程的文本文件,有时还有额外的文件或小程序。一项工作怎么做,你只写一次,之后只要请求对得上,Claude就会照着做。

大多数介绍到这里就结束了,于是有两件事被漏掉。第一,技能可以带着会运行的代码,所以它更像一个装好的程序,而不是一条保存下来的提示词。第二,截至2026年11月,官方页面对描述的长度说法不一:一个说200个字符,另一个说1,024,第三个在技能列表里到1,536就截断。

我是一名营销工程师(Marketing Engineer):12岁起就在数字领域,20岁起做全方位的营销。这篇指南写给不写程序的人,也会指出官方页面之间互相矛盾的地方。

要点先看

  • 技能就是一个装着流程的文件夹。 里面有一个叫SKILL.md的文件,需要时还有参考文件和Claude可以运行的脚本。
  • Claude先读描述。 在请求对上之前,Claude手里只有每个技能的名称和描述。
  • 各页面对描述长度说法不一。 Help Center(帮助中心)允许200个字符,开发者文档允许1,024个,Claude Code的列表在1,536个字符处截断。
  • 技能可以包含代码。 面向组织的官方指南要求,安装技能时要“像在生产系统上安装软件一样严格”。
  • 技能不会自己跟着走。 在应用里上传的技能,不会出现在其他Claude产品中,Claude Code有一个例外。
  • 可重复的流程才值得做成技能。 品牌风格或报告格式很合适;Claude应当一直记住的事实,应该放进常驻指令。

Claude Skills是什么?用大白话说

技能是一个文件夹,它教Claude做好一项工作。里面有一个写着指令的文本文件,有时还有额外的文档或小程序。Claude不会在每次对话中读完整个文件夹:它先读一段简短的描述,等你的请求对上了,才打开其余部分。

官方定义来自Help Center的页面《What are skills?》(什么是技能)。原文的意思是:“技能是由指令、脚本和资源组成的文件夹,Claude会动态加载它们,以提升在专门任务上的表现”。

在Agent Skills概览中,开发者文档说,技能的组织方式“就像你为新同事准备的入职指南”。

一个技能文件夹里有什么?

必需的只有一个文件:SKILL.md,一个写着名称、描述和指令的纯文本文件。其余都是可选的:Claude需要时才读的参考文档,以及脚本,也就是Claude可以运行的小程序。一个报告格式的技能可能只有一个文件;一个填写PDF表单的技能就需要更多。

作者的黏土漫画形象,手里拿着一个打开的文件夹,里面有一张空白指令单和几件小工具

Help Center关于如何创建自定义技能的页面给出了范围。技能“可以简单到只有几行指令,也可以复杂到包含可执行代码的多文件包”。

下表是我自己写的一个小例子,不是真实文件。它是一个月度营销报告的技能,里面只有文字。

文件中的部分示例内容
名称monthly-marketing-report
描述按我们的固定格式撰写月度营销报告。有人要月报或广告活动结果汇总时使用。
第1步开头写三行摘要,让经理20秒内读完。
第2步最多展示三个数字,并说明每个数字的来源。
第3步最后给出下个月要做的一个决定。

名称有规则。开发者文档规定最多64个字符,只能用小写字母、数字和连字符,并且禁止使用保留词anthropic和claude。

Help Center对同一个字段的说法不同:“一个方便人看的技能名称(最多64个字符)”,举的例子是“Brand Guidelines”,有大写字母,也有空格。它还把文件名写成小写的skill.md。我自己的谨慎做法是:像我的例子那样,用小写加连字符的名称,两个页面的要求都能满足。

Claude怎么决定何时加载技能?

Claude会把你的请求和你已启用技能的描述做比较。对上了,就打开那个技能的指令;一个都对不上,技能就保持关闭。开发者文档描述了三层加载,每一层消耗的token(词元,模型用来计算文本量的单位)都不一样。

成本之所以重要,是因为上下文窗口(context window),也就是模型一次能装下的文本量。

三层加载是这样的。

  1. 名称和描述在每次会话开始时加载,成本是“每个技能约100个token”。
  2. 当请求触发技能时,加载SKILL.md的正文,标注为“5k个token以内”。
  3. 额外的文件和脚本只在任务需要时加载,成本是“访问之前为零”。

这个设计的弱点在描述。它是Claude做决定之前唯一能看到的部分,所以描述写得含糊,技能可能一直用不上。写得太宽,技能又会在它本不该处理的请求里被打开。

技能描述能写多长?三个页面,三个数字

这取决于你读的是哪个官方页面。截至2026年11月,Anthropic的三个页面给出了三个不同的数字:描述的两个上限,200和1,024个字符,外加一个在1,536个字符处的截断。这三个页面分属Anthropic文档的三个部分,没有一个说明以哪个数字为准。

信息图,三张卡片分别列出三个官方页面给技能描述的三个数字:200、1,024和1,536个字符

表里出现了三个产品:Claude应用、API和Claude Code。API是程序员把Claude接入自己软件的接口。Claude Code是Anthropic的编程工具,可以在终端里运行,终端就是电脑上的命令行窗口。

官方页面页面所在位置关于描述的说法
How to create custom skills(Help Center)Help Center,面向Claude应用“最多200个字符”
Agent Skills overview(开发者文档)开发者文档,包含API、Claude Code和应用的章节“最多1,024个字符”
Claude Code的Skills文档Claude Code文档“在技能列表中截断为1,536个字符”

Claude Code页面说的是截断,不是上限:description和when_to_use两个字段合起来的文字,在Claude看到的技能列表里会被缩短。所以同一个页面建议:“把关键用途放在最前面”。

各页面对哪些字段必填也说法不一。开发者文档和Help Center都把名称和描述当作必填,而Claude Code页面写的是:“所有字段都是可选的”。在那个页面上,只有描述是推荐填写的,没有名称的技能会用文件夹的名字。

既然没有页面说明以哪个数字为准,我的建议是把描述控制在200个字符以内,这不是官方规则。能装进最小上限的文字,另外两个也装得下。

开发者文档还要求描述同时写清“技能做什么,以及Claude应该在什么时候使用它”。我上表里的示例描述有35个字符,两件事都写到了。

Claude Skills在哪里能用,哪些套餐包含?

截至2026年11月,技能在三个地方可用:Claude应用、Claude Code和API。Help Center仍把API部分标为测试版:“对所有使用代码执行工具的API用户处于beta阶段”。套餐方面,两个官方页面给了两份名单,而且都要求开启代码执行(code execution),也就是让Claude创建文件、运行程序的功能。

Help Center关于在Claude中使用技能的指南写道:“Free、Pro、Max、Ultra、Team和Enterprise套餐的用户都可以使用技能”。它还补充说,在Free、Pro、Max和Ultra套餐上,“你可以启用示例技能,也可以上传自己的技能”。开发者文档则说,应用里的自定义技能“适用于Pro、Max、Ultra、Team和Enterprise套餐”,没有提到Free。

两个页面都没有写单独的价格,所以请查看你自己账户的套餐页面。

默认情况下,技能不会跟着你从一个产品换到另一个产品。开发者文档用粗体写着:“自定义技能不会在不同界面之间同步”,这里的界面指你使用Claude的任何地方。在应用里上传的技能,要在API里再上传一次,而Claude Code把技能作为文件夹放在你的电脑上。

有一个例外,开发者页面没有提到。Help Center说,已启用的技能“在你用同一个Claude账户登录时,也会在终端里的Claude Code中加载”。这需要Claude Code v2.1.273或更高版本,而且只单向生效:从你的Claude账户到Claude Code。

如果Claude Code是用API密钥登录的,这条就不适用,API密钥是程序员用来代替账户登录的一串代码。Claude Code通过其他公司的云服务运行时也一样,比如Amazon Bedrock。

同事是另一回事:Help Center说,自定义技能“在你分享之前,同事是看不到的”。

哪些工作值得做成技能?

你会重复做、而且步骤能写下来的工作。Claude Code文档给了一个检验办法:“当你总是把同样的指令、检查清单或多步骤流程粘贴进聊天时,就该创建一个技能”。如果你发现自己又在粘贴同一段文字,那段文字就是候选。

Help Center列出了典型用途,第一条是“把品牌风格指南应用到文档和演示文稿上”。接着是公司邮件模板和固定格式的会议纪要。

做营销工作,我会从三个技能开始。下面是我的例子,不是官方的,三个都只有文字。

  • 语气风格:品牌用哪些词、避开哪些词,再加两段已批准的范文。
  • 月度报告:固定结构,每个数字都写明来源和日期。
  • 发布前检查:标题、元描述、链接,以及带替代文字的图片。

如果你按一份成文的LinkedIn(领英)内容策略来执行,它的每周例行流程就可以写成一个技能。

在我自己的工作里,交付时用得最多的技能装的是品牌规则,这样图片和文档出来就符合品牌,不用我反复交代。我也让常驻规则保持少而短,把长流程挪进技能。

不是每项工作都能从技能中受益。官方的面向组织的Agent Skills指南提醒,技能“如果触发错误、与其他技能冲突或指令写得不好,会降低智能体的表现”。一次性的任务,或者每次都不一样的工作,我会用普通提示词来处理。

技能和项目指令、连接器、子智能体、保存的提示词有什么区别?

区别在于Claude什么时候读它,以及它是干什么用的。项目指令一直都会加载,技能则按需加载。连接器提供对外部服务的访问,子智能体是一个独立的工作者,保存的提示词是你自己粘贴的文字。

作者的黏土漫画形象,一只手拿着一把大钥匙,另一只手拿着一个打开的文件夹,在比较两者

工具它是什么Claude什么时候读它它用来做什么
项目指令(Claude Code中的CLAUDE.md)写着常驻规则的文本文件每次会话,自动读取Claude应当一直知道的事实
应用里的项目(Projects)带背景知识的工作空间在该项目内的聊天中一直读取一整块工作的上下文
自定义指令(custom instructions)适用于你所有对话的偏好每次对话总体风格和偏好
技能装着流程的文件夹开始时读描述,其余按需读取可重复的流程
连接器(MCP)连到外部服务的链接在Claude Code中:开始时读工具名称,用到工具时再读细节访问工具和数据
子智能体(subagent)有自己上下文的独立工作者任务交给它的时候返回摘要的支线工作
保存的提示词你保存并粘贴的文字只在你粘贴的时候手动复用的简短指令

关于Claude Code的几行依据它的功能概览;关于应用的几行依据Help Center。概览给出的规则是:Claude应当一直知道的东西放进CLAUDE.md,偶尔才需要的参考资料放进技能。这个文件我在CLAUDE.md最佳实践指南里讲过。

连接器(Connector)建立在MCP之上,MCP即Model Context Protocol(模型上下文协议),是把外部服务接入Claude的一种标准方式。Help Center划了一条线:“MCP连接让Claude能使用工具,而技能教Claude如何有效地使用这些工具”。我自己的比喻是:连接器是仓库的钥匙,技能是写好的盘点流程。

子智能体是一个隔离的工作者,接手一项支线任务,再交回一份摘要。子智能体文档说,它“在自己的上下文窗口中运行,有自定义的系统提示词、特定的工具权限和独立的许可设置”。

保存的提示词是最近的亲戚。2025年10月,在程序员论坛Hacker News上关于技能的讨论中,有一位评论者称技能是“一种轻便得多的方式,用来保存和调出我的提示词”。这说的是最简单的技能,但保存的提示词没有脚本,没有额外文件,也没有分层加载。

Claude Code文档里还有一个词:插件(plugin),它把技能、子智能体、连接器和其他部分打包成一个可安装的单元。

不写代码,怎么创建技能?

写一个文本文件,然后上传。Help Center说,任何人都可以用Markdown写指令来创建技能,“简单的技能不需要写代码”。Markdown就是带少量结构标记的纯文本,比如在标题前面加一个井号。

下面是截至2026年11月Help Center描述的步骤。

  1. 确认代码执行已开启:个人套餐在Settings(设置)下的Capabilities(功能)里。
  2. 新建一个以技能命名的文件夹,里面放一个SKILL.md文件:顶部写名称和描述,下面写指令。
  3. 把文件夹压缩成ZIP文件。页面写得很精确:“ZIP应当以技能文件夹为根目录(而不是子文件夹)”。
  4. 在应用里打开Customize(自定义),再打开Skills,点击加号按钮,选择Create skill(创建技能),然后选Upload a skill(上传技能)。
  5. 启用这个技能,用几个不同的请求测试。页面建议:“如果Claude没有在预期的时候使用它,就反复修改描述”。

还有第二条路:你一边做任务一边录屏,Claude据此提出一个技能,交给你审核。Help Center对此有限制:“录制技能适用于Pro、Max、Ultra和Team套餐,在Claude for Mac的Cowork中使用”。Cowork是Claude桌面应用的一部分。

页面说视频和音频不会保留,但会保存这次会话的一组截图。它的提醒我会照字面执行:“录制时不要输入密码或机密信息,也不要显示敏感信息或私人对话”。

Claude Code Skills有什么不同?谁来按按钮?

核心格式是一样的,但技能以文件夹的形式放在你的电脑上,没有上传这一步。个人技能放在~/.claude/skills/,也就是你用户目录下的一个文件夹;项目技能放在该项目里的.claude/skills/。Claude可以自己挑选技能,你也可以在斜杠后面输入名称来调用。

在Claude Code里,你还可以决定每个技能由谁来启动。一个叫disable-model-invocation的设置,能让技能只在你输入它的命令时才启动。文档用部署举例说明原因,部署就是让新软件正式上线:“你不会希望Claude因为觉得代码看起来准备好了,就自己决定部署”。

作者的黏土漫画形象,一根手指悬在一个大圆按钮上方,神情谨慎而审慎

发送邮件或发布页面,我也用同样的逻辑。我的很多流程技能都保持在明确下命令时才启动,因为一个在错误时机自动启动的技能,浪费的时间比它省下的还多。

面向组织的指南还为技能本身加了第二道保险:“技能的作者不应该自己审核自己”。

现成的Anthropic Skills从哪里来?

截至2026年11月,来源有三个:Claude内置的技能、应用里的一个目录,以及GitHub上的一个公开仓库,GitHub是程序员发布代码的网站。它们的区别在于是谁做的,以及需要你检查多少。

内置技能可以生成Excel、Word、PowerPoint和PDF文件。Help Center说,这些Anthropic技能“对所有用户开放,相关时Claude会自动调用”。

技能、连接器和插件目录就在应用里,Help Center说其中收录了合作公司开发的技能。从这里安装的技能是只读的:想修改,就要把改过的副本当作你自己的技能上传。

第三个来源是GitHub上的anthropics/skills仓库。2026年11月18日,它显示约197,000个星标(star),作用类似书签,以及约23,100个分叉(fork),也就是仓库的个人副本。两个数字都只说明关注度,跟质量无关。

仓库自己写明了定位:“这些技能仅用于演示和教学目的”。

我试过一些大型的公开技能合集。里面大部分内容服务的是用某一种特定技术工作的人,所以我装得很少。

什么是Agent Skills?这个格式开放吗?

Agent Skills是Claude Skills背后那个格式的名称,它作为开放标准发布。Agent Skills网站把它描述为“一种轻量、开放的格式,用专门的知识和工作流来扩展AI智能体的能力”。

AI智能体是按步骤执行任务的模型,就像我在AI营销智能体一文里写的那样。

这个格式起源于Anthropic。它关于Agent Skills的工程文章发布于2025年10月16日。2025年12月18日的一次更新写道:“我们已将Agent Skills作为开放标准发布,以实现跨平台可移植”。

开放不等于通用。Help Center的措辞带着条件:“同一个技能格式,可以在采用这一标准的AI平台和工具之间通用”。Agent Skills网站说它“已被越来越多的智能体产品采用”,还链接了一个案例展示页,所以请核实你用的那个产品。

Claude Code文档说,它在这个格式上做了扩展,加入了“调用控制、子智能体执行和动态上下文注入”等功能。依赖这些额外功能的技能,换到别的产品里不一定表现一样。

安装技能的风险在哪里?

风险在于,技能可能包含你没读过的指令和代码。开发者文档说得很直接:“只使用来自可信来源的技能:你自己创建的,或从Anthropic获得的”。其他来源的技能,启用前都需要审查。

信息图清单,安装技能前的五项检查:读完每个文件、检查脚本、隐藏指令、网络调用、不存密码

同一个页面解释了机制:恶意技能“可以指使Claude以与技能声明用途不符的方式调用工具或运行代码”。根据Claude能接触到什么,页面列出了三种后果:数据在你不知情时被复制出去、对系统的未授权访问,以及其他安全风险。所以面向组织的指南说:“对待技能安装,要像在生产系统上安装软件一样严格”。

生产系统就是公司每天都依赖的那些系统。指南里有一份八个步骤的审查清单;我的精简版有五步。

  1. 读完文件夹里的每个文件,不只是SKILL.md。
  2. 检查每个脚本做的事是否和描述一致。
  3. 留意那些让Claude无视规则、或对你隐瞒操作的指令。
  4. 留意网址和网络调用,数据可能从那里流出。
  5. 确认文件里没有存放任何密码或访问密钥。

这就是我在AI幻觉与人工审核一文里讲的习惯:机器动手之前,先由人来读。纯文字的技能读起来很快;带脚本的技能,我会请一位能读懂代码的人看。

一个有害技能能走多远,取决于产品。根据开发者文档,API上的技能运行时没有网络访问。在Claude Code里,它们“和用户电脑上的任何其他程序拥有同样的网络访问权限”,在应用里则取决于用户和管理员的设置。

自动检查是有的,但有局限。根据Help Center关于技能扫描的页面,截至2026年11月,Enterprise组织可以对上传的第三方技能进行扫描,结果有三种:通过、警告或失败。

页面补充说,通过“并不保证技能在各方面都安全”。面向组织的指南还指出了第二个局限:“扫描不覆盖Claude API”。

这条规则也适用于你自己写的技能:清单里说,凭据,也就是密码和访问密钥,绝不应该出现在技能内容里。更深入的内容,我写在AI智能体安全一文中。

装了太多技能会怎样?

Claude可能会丢掉它在技能之间做选择所需要的文字。在Claude Code里,每个技能的名称都会留在列表中,但技能一多,为了不超出一个大小预算,有些描述会被删掉。没有了描述,技能就更难和请求对上。

截至2026年11月,Claude Code文档说,这种截断会“删掉Claude用来匹配你请求的关键词”。这个预算“按模型上下文窗口的1%计算”,描述会“从你最少调用的技能开始”被删掉。

大小预算只在Claude Code的文档里有说明。面向组织的指南给出了通用的说法,没有数字:“启用的技能太多时,Claude可能选不中正确的技能,或者完全漏掉相关技能”。

第二个影响是冲突。面向组织的指南列出了一种情况:新技能的描述太宽,“抢走了现有技能的触发”。我的做法由此而来:列表要短,不用的文件夹就删掉。

一条真实评论:描述决定技能会不会运行

技能在2025年10月推出,Hacker News上随后有一场很长的讨论。那几天里的一条评论提出了一个担忧。

黏土漫画形象指着一张大引语卡片,卡片上是一条真实的Hacker News评论,说Claude只会粗略浏览技能描述

来自Hacker News上关于Claude Skills的讨论帖的真实评论,2025年10月。

这条评论看到了一个风险:“the capability of the system to use the right skill is limited by the little blurb you give about what the skill is for”(系统用对技能的能力,受限于你为技能用途写的那一小段简介)。它的最后一句是:“But Claude is always starting from ground zero and skimming your descriptions”(但Claude每次都从零开始,粗略扫一遍你的描述)。

我也有这个担忧。按开发者文档里的数字,Claude在做决定之前,每个技能手里只有大约100个token的名称和描述。在那之前,文件夹里的其他内容它都看不到。

这条评论拿人来比较:人会越来越清楚什么时候该用哪个工具。对技能来说,这种进步只能来自作者:用真实的请求去测试,技能没加载时就改写描述。

常见问题

Claude Skills是什么?

Claude Skills是由指令、脚本和资源组成的文件夹,只有任务需要时Claude才会加载。每个技能都有一个SKILL.md文件,里面写着名称、描述和流程。

Agent Skills是什么?

Agent Skills是Claude Skills背后那个开放格式的名称。它起源于Anthropic,并在agentskills.io上作为开放标准发布。

哪些套餐包含Claude Skills?

截至2026年11月,Help Center列出了Free、Pro、Max、Ultra、Team和Enterprise,并说Free用户也能上传自己的技能。开发者文档对应用里的自定义技能只列了付费套餐,没有提到Free。两者都要求开启代码执行。

怎么教Claude学会一个技能?

把流程写进一个SKILL.md文件,把它所在的文件夹压缩成ZIP,在Customize下的Skills里上传。在部分套餐上,你也可以在Mac上录屏,让Claude提出技能。

Claude从哪里读取技能?

在应用里,读取你账户中在Customize下的Skills里启用的技能。在Claude Code里,读取你电脑上的文件夹:个人技能在~/.claude/skills/,项目技能在.claude/skills/。

Claude有技能生成器(skill builder)吗?

截至2026年11月,没有叫这个名字的功能。官方页面描述的是:在Mac上录制任务,在聊天中和Claude一起编辑技能文件,以及在Claude Code中用来测试技能的skill-creator插件。

Claude Skills安全吗?

这取决于技能从哪里来、里面装了什么。Anthropic的文档说只使用来自可信来源的技能,面向组织的指南则要求像审查新软件一样审查技能。

ChatGPT能像Claude一样创建技能吗?

截至2026年11月,OpenAI的ChatGPT价格页面在每个个人套餐里都列出了技能(skills),所以ChatGPT有一个同名功能。Agent Skills作为开放标准发布,其他产品可以采用,两个助手的对比我写在Claude vs ChatGPT里。

Claude Skills小结

Claude Skills是装着成文流程的文件夹,只有任务对上描述时,Claude才会加载。值得为重复做的工作搭建技能,而任何带代码的技能,都应该像你要安装的程序一样经过检查。

我写营销、AI以及它们背后的数字。如果这篇对你有用,欢迎在LinkedIn上关注我。

标签: claude skillsclaude code skillsagent skillsanthropic skillsai智能体ai营销

继续阅读

全部文章 →
订阅通讯

抢先一步。

偶尔分享关于 AI 营销、增长与演讲的思考。绝无垃圾邮件。