【导读】一位 Claude 重度用户在看完 Anthropic 工程师的演讲后发帖:"Skills 就是文件夹?"帖子被 224 万人看到。但 Skills 远不止"文件夹"——它的背后是动态发现、按需加载、可组合的 Agent 能力封装机制,GitHub 仓库已超 13 万 Star,第三方框架也在跟进。
「我每天都在用 Claude,直到看了这场演讲」
X 用户 Kaito(@KaitoEtLIA)是个 Claude 重度用户。
他每天都在用,自认为已经够熟练了。
直到他看了两位 Anthropic 工程师——Barry Zhang 和 Mahesh Murag——在 AI Engineer 大会上关于 Claude Skills 的讲解。
他发了一条法语帖子,逐行记录自己的心理过程:
"- j'utilise Claude tous les jours
- je me crois assez bon là-dedans
- je regarde deux ingénieurs Anthropic pendant 2 HEURES
- l'ingénieur de Claude explique les Skills from scratch
- les 5 premières minutes
- attends. Les Skills c'est juste des dossiers ?"
「我每天用 Claude / 觉得自己挺厉害 / 看了两位 Anthropic 工程师讲了 2 小时 / Claude 工程师从零讲 Skills / 前 5 分钟 / 等等……Skills 就是文件夹?」
▲ Kaito 在 X 上的帖子(224 万次浏览)
他说自己看到第 16 分钟时彻底理解了:Skills 就是一种保存 workflow、领域知识和专业经验的地方。
然后他想起了过去的每一次崩溃——
每次都要从零重写 prompt。每段上下文都要重新解释。每个 session 结束,Claude 又把一切忘光。
帖子最后一行是一句法语双关:skill issue détecté——"检测到技能缺陷",也是英语社区里"你菜"的经典梗。
评论区迅速聚集了大量开发者。有人说自己也经历了同样的震惊时刻,有人开始追问机制细节,也有人表示怀疑。
「文件夹」三个字,让一群开发者集体破防
因为 Claude Skills 的最小形式,确实就是一个文件夹。
Anthropic 工程师在演讲中这样定义:
"Skills are organized collections of files that package composable procedural knowledge for agents. In other words, they're folders."
「Skills 是把可组合的程序化知识打包给 Agent 的文件集合。换句话说,它们就是文件夹。」
官方工程博客的表述几乎一样:
"Agent Skills are organized folders of instructions, scripts, and resources that agents can discover and load dynamically."
「Agent Skills 是由指令、脚本和资源组成的文件夹,Agent 可以动态发现并加载它们。」
▲ Anthropic Engineering 博客正式介绍 Agent Skills
最简单的一个 Skill,只需要一个文件:SKILL.md。
这个文件用 YAML frontmatter 写上 `name` 和 `description`,正文写操作说明和 guidelines。没有 API 注册,没有 schema 定义,没有编译打包。
一个带 YAML 头的 Markdown 文件,放在一个文件夹里。
这就是一个 Skill。
工程师在演讲中还强调,这种简单性是刻意设计的:因为任何有电脑的人和 Agent 都能创建和使用 Skills。它们可以进 Git 做版本管理,可以放进 Google Drive 共享,可以 zip 打包发给同事。
启动只给名字,用到才读全文:三层加载机制
Skills 看起来简单,但运行机制完全不简单。
Claude 文档把它叫做progressive disclosure(渐进披露),分三步:
第一步:Metadata loading。Claude 启动时,只读取所有已安装 Skills 的 `name` 和 `description`。不读正文,不读脚本,不读任何资源文件。上下文占用极小。
第二步:Activation。当用户的任务匹配到某个 Skill 的描述时,Claude 才读取完整的 `SKILL.md`。
第三步:Resource loading。如果任务需要更多信息,Claude 继续读取目录里的脚本、模板、参考资料等文件。
▲ Claude 官方文档详解 Skills 的渐进加载机制
这个设计解决了什么问题?
传统工具的做法是把所有工具定义——API schema、函数签名、参数说明、用法示例——一次性塞进模型上下文。工具越多,上下文越拥挤,token 消耗越大,模型选择工具时的负担也越重。
Skills 换了一个思路:大量专业知识留在文件系统里,启动时只给模型一行描述,需要的时候再逐层加载。
LangChain 在他们的博客里把这个优势总结为两点:token efficiency(启动时只加载 YAML frontmatter)和reduced cognitive load(Agent 面对少量原子工具,而非大量相互重叠的工具定义)。
跟 Projects 和 MCP 到底什么区别?
很多人第一反应是:这跟 Projects 有什么不同?跟写个长 prompt 有什么不同?
Claude 文档给了明确的功能分区:
- Skills
:针对特定任务的程序化知识,动态加载,可以包含脚本和资源 - Projects
:静态背景知识,在整个对话中保持不变 - MCP(Model Context Protocol)
:连接外部服务和数据源 - Custom Instructions
:全局偏好设置,每次对话都会应用 - Plugins
:可分享的包,能把 Skills、连接器、子 Agent 打包在一起
关键区别在于:Skills 能带可执行代码。
Claude 可以按需执行 Skill 目录里的 Bash 脚本、Python 脚本或其他程序。它把指令和操作封装在一起——你告诉 Agent「怎么做」的同时,也直接给它「做的工具」。
这让 Skills 更像一个可安装、可触发、可分享的能力单元,而非一份静态参考资料。
13 万 Star 仓库:外部生态已经在跟进
Anthropic 在 GitHub 上发布了 `anthropics/skills` 仓库,提供 Skills 的示例和规范。
截至本次采集,仓库数据:136,062 个 Star、16,040 个 Fork、855 个 open issues。
▲ anthropics/skills 仓库,超 13 万 Star
仓库 README 再次确认了最低门槛:每个 Skill 自包含在一个文件夹里,核心是带 YAML frontmatter 的 `SKILL.md`,frontmatter 只需要 `name` 和 `description` 两个字段。
外部框架也在跟进。
LangChain 把 Skills 解读为"把 actions 从工具定义卸载到文件系统"的模式,并宣布 deepagents-CLI 已经增加了 Skills 支持,用户可以把 Skills 文件夹放到 `~/.deepagents/agent/skills` 目录下使用。
▲ LangChain 将 Skills 纳入 Deep Agents 工作流
Skills 正在从 Anthropic 的内部功能,变成一种跨框架的 Agent 能力分发格式。
社区的另一面:「fairly unreliable」
Kaito 的帖子下面,并不全是"恍然大悟"的反应。
@aiseomastery 说:
"Skills are just folders and I also had to sit with that for a minute."
「Skills 就是文件夹,我也花了一分钟才消化这件事。」
@MoMoMacro 提醒了一个容易被忽略的细节:
"Folder is the easy part. Description field decides whether Claude actually loads it."
「文件夹只是门槛最低的部分。Description 字段才决定 Claude 到底会不会加载这个 Skill。」
这条评论指向了一个核心问题:Skill 的触发完全依赖 `description` 的质量。写得含糊,Claude 根本不会调用。
@Sangeli7 对此持怀疑态度:
"fairly unreliable"
他认为 Skills 文件中的信息,Claude 依然会遗忘,触发并不稳定。
@julianharris 则提到 Skills 可以包含 Bash 脚本,但有用的上下文仍然很难构建。
也有乐观的声音。@IsoscelesKr4mer 建议,在完成一个可复用 workflow 后直接让 Claude "save this as a skill"——把日常操作沉淀成可复用的能力包。
整体来看,社区的态度可以归纳为:Skills 降低了封装和复用的门槛,但触发准确性、上下文质量和长期记忆问题仍然没有自动解决。
安全警告:能装就能被利用
Anthropic 官方博客在介绍 Skills 的同时,专门给出了安全警告。
Skills 既可以包含指令,也可以包含可执行代码。这意味着恶意 Skill 可能让 Claude 执行非预期动作、外传数据,或引入安全漏洞。
官方给出的建议:
-
只安装来自可信来源的 Skills -
安装前审计文件内容、依赖关系和外部网络连接 -
对团队共享的 Skills 做代码审查,和审查普通代码一样
当 Skills 可以像文件一样复制、安装、分享时,安全审计的责任就落在了每一个安装者身上。这跟 npm 包、VS Code 插件面临的困境本质相同:开放生态的便利性和安全性永远是一对张力。
一个文件夹能走多远?
回看这件事,最值得注意的地方在于 Anthropic 的设计选择。
他们没有为 Agent 能力创造新的协议、新的格式或新的运行时。他们选择了文件系统——人类和 Agent 都已经拥有的最基础工具。
一个文件夹、一个 `SKILL.md`、几行 YAML metadata,就能把用户或团队的流程、知识、脚本和规则,变成 Agent 可以发现、执行、分享的能力单元。它可以进 Git 做版本管理,可以用 Google Drive 分享,可以 zip 打包发给同事。
13 万 Star 的仓库、第三方框架的跟进、社区的激烈讨论,都指向同一个判断:Agent 能力的分发入口,可能就是一个写得好的文件夹。
但"写得好"三个字,才是真正的门槛。
Skill 好不好用,取决于 `description` 写得够不够准确、instructions 够不够清晰、scripts 够不够可靠、迭代够不够持续。真正有价值的 Skill,需要和写好一段代码一样的投入。
文件夹的门槛很低。但好的 Skill,门槛一点都不低。
— END —



