你大概常听到一个词，Skill。很多人开始"做Skill"，做得跟建一个代码仓库似的，一个文件夹、一堆文件，搞得挺正式。
如果你是零基础，第一反应多半是一连串问号。这玩意儿到底是啥？跟我平时直接跟AI说话，也就是写prompt，有啥不一样？SKILL.md里到底该填什么？做好之后怎么装进Claude？我为Claude写的，能不能搬到OpenAI或者别的工具上用？还有那个最让人犯嘀咕的：我吭哧吭哧写一个Skill，AI真的会"用"它吗，还是跟prompt一样，扔进去不是石沉大海，就是量子力学？
这篇文章就当一份手把手的教程，把上面每一个问题都写到你能照着做。不需要任何编程基础，每一步该建什么文件、填什么字段、点哪个按钮，我都写清楚。读完你能亲手做出一个能跑的Skill，并且知道它在Claude、在OpenAI、在别处分别怎么用。

先交代一个背景，免得你以为这是什么小众玩意儿。Skill是Anthropic（做Claude的公司）2025年10月16日推出的，两个月后的12月18日，又把它的规格作为开放标准公开，明确写着目标是"跨平台通用"。到2026年，Claude、Codex、Gemini CLI等主流Agent工具已经开始支持这套格式。它早已超出某一家公司的范围，正在变成行业的通用零件。

一、三个概念先分清：prompt、Skill、Claude Skill

很多人一上来就被几个词绕晕，prompt、Skill、Claude Skill、MCP、插件，听着像一回事。这一章先把它们一刀一刀切开，后面才不会糊涂。


1.1 prompt：你对 AI 说的话

prompt（提示词）就是你对AI说的话，这是最朴素的起点。
你打开AI，敲一句"帮我把这段话翻译成英文"，这句话就是一个prompt。你交代得越清楚，它干得越好。你说"翻译成英文"，它给你一版。你说"翻译成英文，语气正式一点，给客户看的"，它给你的就稳当得多。过去两年大家挂在嘴边的"提示词工程"，剥开就是一件事：研究怎么把话说好。
prompt有个躲不掉的毛病：它是一次性的、口头的。就像你叫了个临时帮手，每次都得从头交代一遍。公司周报有固定格式，你今天让AI按格式整理一份，得把要求全打一遍。AI干完，对话窗口一关，这套要求它就忘得干干净净，下周再要还得从头说。说漏一条，它就漏做一条。这种重复全压在你身上，靠你的记性。
1.2 Skill：写成文件夹、能被反复调用的说明书

Skill就是把"这件事该怎么做"写成一份说明书，存成一个文件夹放好，需要时让AI自己去翻。
还拿周报那个例子。用prompt的活法，是每周把那一长串格式要求重新打一遍。用Skill的活法，是你把这套要求写成一份说明书存好，以后只要说一句"整理本周周报"，AI自己就想起"这事我有本手册"，翻开照着做。
它跟prompt最硬的三条区别，记住就够用。第一，prompt是临时的，Skill是常驻的，一个说完就没，一个存着反复用。第二，prompt靠你每次记得说全，Skill把要求固化下来，由AI自己去取。第三，prompt只能是一段文字，Skill是一个文件夹，里面除了说明书，还能放参考资料、放素材，甚至放一段能直接运行的小程序。最后这点是Skill真正的杀手锏，第二章细讲。
1.3 "Claude Skill"和"Agent Skills 开放标准"是什么关系

你会看到两种叫法，Claude Skill和Agent Skills，它们说的是同一套东西，只是角度不同。
Agent Skills是这套格式的正式名字，也是那份开放标准的名字，由Anthropic制定。Claude Skill通常指的是你在Claude这个产品里用的Skill。打个比方，Agent Skills是"USB接口标准"这份规格书，Claude Skill是"插在Claude这台电脑上的U盘"。规格是开放的，所以同一个U盘也能插到别的认这套标准的电脑上，这就是第五章要讲的跨平台。
时间线理清楚：2025年10月16日，Anthropic在Claude里上线了Skills功能。2025年12月18日，它把这套格式作为开放标准公开发布。注意一件容易混的事，开放标准跟"捐给基金会"是两码事。Anthropic确实在2025年12月把另一套东西MCP捐给了Linux基金会，但Agent Skills到目前为止并没有交给任何基金会，它是Anthropic主导、对社区开放贡献的模式。
1.4 Skill 不是 MCP，也不是插件：一句话划清边界

这几个词经常一起出现，容易混，这里各给一句话。
Skill是"写给AI看的操作手册"，告诉它某类任务该怎么一步步做。MCP（模型上下文协议）是"AI连接外部工具和数据的标准接口"，管的是AI怎么够到你的数据库、你的日历。一个偏"怎么做事的知识"，一个偏"怎么连外部系统"，两者还能配合，比如官方就有一个专门帮你搭MCP服务的Skill。
插件（plugin）则是更大的打包单位，一个插件里可以同时装着若干个Skill、若干条命令、若干个MCP连接。你可以把插件理解成"一个工具箱"，Skill是工具箱里的一把把工具。分清这三者，后面就不会犯迷糊。

二、解剖一个 Skill：内部有哪几块

概念讲清楚了，这一章把一个Skill彻底拆开，看它由哪几块拼成，每块装什么。看完你脑子里要有一张清晰的结构图。


2.1 本体就是一个文件夹

一个Skill，本体就是电脑上的一个普通文件夹。文件夹的名字就是这个Skill的名字，里面至少装一个叫SKILL.md的文件。一个完整些的Skill，目录大致长这样：

记住这个结构：一个跟Skill同名的文件夹，里面一个必需的SKILL.md，外加scripts、references、assets三个可选子目录。最小的Skill就一个SKILL.md，三个子目录一个都不要也能跑。
2.2 SKILL.md 第一部分：开头的字段（frontmatter）

SKILL.md这个文件分成上下两部分。上半部分是一段用三道横线框起来的设置区，行话叫frontmatter，专门写这个Skill的基本信息。它长这样：
---
name: weekly-report
description: 按公司格式整理每周工作周报。当用户说"写周报""周总结""整理本周工作"时使用。 ---
这里逐个字段说清楚，哪些必填、有什么硬规矩。
name（必填）是Skill的名字。规矩很死：最多64个字符，只能用小写字母、数字和连字符，开头结尾不能是连字符，不能有连续两个连字符，而且必须跟文件夹名字一模一样。还有两个保留词不能用，名字里不能含anthropic或claude。
description（必填）是一句简介，也是整个Skill最该花心思的一行。它要同时说清两件事：这个Skill干什么，以及什么时候该用它，最好带上能触发它的关键词。长度上，claude.ai网页端要求大约200字以内，通过API上传可以放宽到1024字符，但别贪长，写清楚就好。为什么这行这么重要，第三章会专门讲，因为它是AI决定用不用这个Skill的主要依据。
剩下几个是选填的，零基础阶段用不上，知道有就行。license写许可证。compatibility写运行环境要求，比如需要联网、需要某个Python版本，最多500字符。metadata是个自由的键值表，可以塞作者、版本号这类附加信息。allowed-tools预先批准这个Skill能用哪些工具，写法像 Bash(git:*) Read，不过它还是实验性的，各家支持不一，先别依赖。
2.3 SKILL.md 第二部分：正文

三道横线下面的全部内容，是这个Skill的正文，用普通Markdown文字写，就是带点格式的记事本。这部分是真正的"操作手册"，告诉AI这类任务该怎么一步步做。<