先说结论
Skill 就是一个文件夹，里面放着一个 SKILL.md。文件开头是一小段头信息，写着 name 和 description，后面才是具体指令。平时 Agent 只记着名称和描述，等你的请求对上了，才去读后面的内容。同一个文件夹，Claude Code、Codex 和 Cursor 都能直接用。
为什么会有 Skills？
你可能也这样干过
你攒了一段 40 行的落地页 Prompt，版式、板块、手机上要检查什么，全写在里面。每次都得粘贴一遍，哪次漏了一行，页面就做歪了。同事来要“那段 Prompt”，你发过去的还是上个月的旧版。
Skill 就是把这段 Prompt 收进一个文件夹，让 Agent 自己去找。比如 Meridian Marketing Landing，装好之后，Agent 已经知道方格纸背景的 Hero、功能网格和价格切换开关怎么做，你只要把产品信息告诉它。
常见的 Claude Skills 例子都是这个思路：把做某一类东西的方法固定下来。Notion Style OG Image 专门做 16:9 的分享图，Skillry 上还有做 PPT、简历网站和短视频的 Skill。
| 每次粘贴 Prompt | 用 Skill | |
|---|---|---|
| 要交代什么 | 版式、板块、风格、检查项，每次重讲一遍 | 只说你的内容 |
| 每次跑出来 | 多少会有偏差 | 按同样的步骤走 |
| 分享给别人 | 从聊天记录里翻出来发 | 装同一个文件夹就行 |
SKILL.md 文件里写什么？
Skill 只有一个必需文件 SKILL.md，另外可以带几个可选文件夹，放参考文档、脚本和模板。SKILL.md 分两部分：开头用 --- 包起来的一小段头信息，后面是写给 Agent 看的指令。
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
最多 64 个字符，只能用小写字母、数字和连字符，并且要和文件夹同名。
description
最多 1,024 个字符。写清它做什么，以及什么时候该用，Agent 主要靠后半句来挑它。
可选
license、compatibility、metadata、allowed-tools
这些限制出自开放的 Agent Skills 规范。Claude Code 要宽松一些：name 可以不写，默认用文件夹名。
Agent 怎么决定用哪个 Skill？
它拿你的请求去和每个 Skill 的描述比对。为了不浪费上下文，Skill 是分三步加载的：
- 1启动时，只读每个已装 Skill 的名称和描述，别的一概不看。
- 2你的请求对上某个描述，或者你直接点名调用时，才加载完整的
SKILL.md。 - 3干活的过程中，只有指令里写明了，它才会去翻
references/里的文件，或者运行scripts/。
所以装几十个 Skills 也不会拖慢 Agent。没用到的时候，一个 Skill 只占差不多一句话的上下文。
| Agent | 点名调用 Skill |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name，或者从 /skills 里选 |
| Cursor | /skill-name，或者用 @skill-name 附加进来 |
Agent 能不能自动挑中，全看描述写得好不好。触发机制讲了怎么写出容易被选中的描述；在那之前，直接点名调用总是管用的。
哪些 Agent 能用 Skills？
主流的基本都能用。这套格式是 Anthropic 为 Claude 设计的，2025 年 12 月 18 日作为开放标准发布。现在 agentskills.io 上已经列出几十款支持它的工具，包括 Claude Code、ChatGPT 和 Codex、Cursor、VS Code、GitHub Copilot、Gemini CLI。
| Agent | 个人目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/（旧的 ~/.codex/skills/ 也会读） |
| Cursor | ~/.cursor/skills/ 或 ~/.agents/skills/ |
放在个人目录里的 Skill，你电脑上的每个项目都能用。项目级目录和 Agent 会查找的其他位置，都列在 Skill 存放位置 里。
用 Skill 还是直接写 Prompt？
同一件事要反复做，还希望每次质量一样，就做成 Skill；只做一次的事，写 Prompt 就够了。
这事你还会再做
- 需要示例、脚本或检查清单
- 希望每次结果都一样
- 别人也用得上
只做这一次
- 几句话就能说清
- 你自己还没想清楚要什么
- 没什么值得复用的
大多数时候两者一起用：Prompt 说今天要什么，Skill 管怎么把它做好。想细看可以读 Skills 和 Prompt 的区别。
装 Skill 之前，先查这几样
Skill 可以在你的电脑上跑脚本，所以每装一个新的，都先花几分钟看一眼。
五分钟检查
- 读一遍
SKILL.md，留意它能改动哪些东西。 - 把
scripts/里的内容全部读完，这些脚本会在你的电脑上运行。 - 看 Skill 页面上的依赖项和外部成本。
- 密码和 API key 别写进 Skill 文件，也别发到对话里。
常见问题
Claude Skills 是什么？
就是 Agent Skills 在 Claude 和 Claude Code 里的常用叫法。格式完全一样：一个带 SKILL.md 文件的文件夹，而且这个文件夹在 Codex 和 Cursor 里也能用。
Claude 怎么知道该用哪个 Skill？
它把你的请求和每个 Skill 的描述对比，加载最合适的那个。直接输入 /skill-name，就省得它去猜。
Claude Skills 可以免费用吗？
Skill 只是几个文件，免费的 Skill 本身不花钱。不过你得有一个支持 Skills 的 Agent，比如 Claude Code、Codex 或 Cursor，按那个产品的套餐来用。Skillry 上也有免费 Skill，比如 Dot Avatar Maker。
Skill 和 MCP 服务器是一回事吗？
不是。Skill 教 Agent 一套做法，MCP 服务器负责把 Agent 接到外部数据和工具上。两者经常一起用，详见 Skills 与 MCP 的区别。
参考来源
这篇对你有帮助吗？