专业版$9.99/月，访问全部 Premium Skills，随时取消。查看方案
全部指南
指南2026/08/30

什么是 Agent Skill？一篇看懂 SKILL.md

Agent Skill 是一组按需加载的 AI 工作说明。本文介绍 Skill 里有什么、它和提示词及 MCP 服务器有什么区别，以及什么时候值得安装。

最简单的方法

让 AI 帮你做

把下面这句话发给你正在使用的 AI Agent：

请用通俗的话向我解释 Agent Skill。把 Skill 和普通提示词、MCP 服务器做个对比，给我一个具体例子，然后问我希望 AI Agent 帮我完成哪类工作。

Agent Skill 是一个装着工作说明的文件夹。AI Agent 只会在任务匹配时读取它。文件夹里一定有一个 SKILL.md，通常还会带上参考资料、模板或脚本。你只需要安装一次，之后 Agent 遇到对应任务，就知道该按什么方法、什么标准完成。

先看结论

  • Skill 是一个文件夹，并非设置项、订阅或模型。
  • Agent 平时只看到 Skill 的简短描述，任务匹配时才打开完整说明。
  • Skill 提供的是做事方法；MCP 服务器提供的是数据和系统访问能力。
  • Skill 主要由普通文本文件组成，可以阅读、比较版本，也能放进 Git 管理。
  • 出现问题时，你可以直接打开说明，检查 Agent 为什么这样做。

一个 Skill 里面有什么

下面是一个真实例子：story-first-deck。它负责把大纲做成一份结构清楚的演示文稿：

story-first-deck/
├── SKILL.md                  核心工作说明
├── references/
│   └── workflow.md           需要时才读取的详细流程
├── skill-manifest.json       版本、产出类型、依赖等元数据
└── LICENSE.md

SKILL.md 开头是一小段 frontmatter（文件元数据），后面是普通 Markdown 正文：

---
name: story-first-deck
description: Build a story-first presentation by choosing the right
  production lane: native PPTX, HTML, image-first, or carousel.
---

# Story-first Deck

Build a story-first presentation by choosing the right production lane…

核心格式就是两个字段加一段正文。它不需要编译，也没有需要学习的插件 API。Agent 只有在任务匹配时才会读取并执行里面的步骤。

复杂工作可以带更多文件。比如，我们内部用于部署网站的 Skill 会带 scripts/，存放 Agent 需要运行的脚本；也可能带 agents/，保存不同 Agent 的配置。最简单的 Skill 只需要一个 SKILL.md。

Agent 如何决定是否使用 Skill

这一点最容易让人困惑，也解释了很多“装了却没触发”的情况。

Agent 不会在每条消息里完整读取所有 Skill。它平时只看每个 Skill 的 description。当你的要求与描述匹配时，Agent 才会打开完整的 SKILL.md 并遵循其中的流程。

这会带来两个直接结果：

描述决定能否匹配。 描述太含糊，即使 Skill 很适合当前任务，也可能不会被调用。已经安装却始终不触发时，先检查 description，再检查正文。

Skill 贵精不贵多。 每个已安装 Skill 都会增加 Agent 需要判断的候选项。保留真正经常使用、边界清楚的 Skill，通常比一次安装几十个更稳定。

Skill、提示词、MCP 服务器和插件有什么区别

这四个概念经常被混在一起，其实它们解决的是不同层面的问题：

类型解决什么问题以什么形式存在什么时候使用
提示词这一次想让 AI 做什么对话里的一条消息只做一次的任务
Agent Skill一类工作以后都该怎么做带 SKILL.md 的文件夹经常重复同类工作，而且有固定标准
MCP 服务器如何访问对话外的数据和系统持续运行的服务Agent 需要数据库、API 或文件系统
插件如何改变宿主应用本身宿主专用的软件包需要扩展工具本身的行为

最实用的区分是：方法和访问能力。Skill 教 Agent 如何按你的标准制作演示文稿；MCP 服务器让它取得第七页需要的数据。很多任务会同时用到两者，它们并不互相替代。

什么时候值得安装 Skill

适合安装：

  • 你会反复制作同一种成果，例如演示文稿、文章配图、落地页或报告。
  • 你脑中有一套标准，每次都要重新向 AI 解释。
  • 工作需要按固定顺序完成多个步骤。
  • 最终成果必须符合别人规定的格式。

不太适合：

  • 只会做一次的任务，直接写提示词更省事。
  • 每次需求都完全不同，没有可复用的方法。
  • 真正的问题是无法访问数据，这时更需要 MCP 服务器。

一个很直观的判断方法：如果同一套偏好你已经向 AI 解释过三次，就值得把它整理成 Skill。

Skill 从哪里来

GitHub 上有许多可以直接克隆的开放合集，也有厂商发布自己的 Skill。它们的质量差异很大。单看文件，很难判断一个 Skill 是否经过真实运行，还是只在一个下午写完后就再也没有测试。

这正是 Skillry 要解决的问题。目录里的每个 Skill 都经过整理，并展示真实产出。我们在支持的 Agent 中实际运行过后，页面还会显示 Last tested（最近测试） 日期和测试所用的 Agent。你可以先浏览 Skill 目录、查看结果，再决定是否安装。

常见问题

Agent Skill 和 Claude Skill 是一回事吗？ Claude Skills 是目前常见的一种实现。文件夹加 SKILL.md 的结构是开放的，因此其他支持这一格式的 Agent 也能读取同一套文件。可以继续阅读如何在 Codex 和 Cursor 中使用 Skill。

需要会写代码吗？ 不需要。安装就是把文件夹放到 Agent 会读取的位置；使用时照常用自然语言说明你想完成什么。

运行 Skill 会产生费用吗？ Skill 本身只是文本。费用来自 Agent 使用的模型，以及 Skill 调用的外部服务，例如图片或视频生成。写得好的 Skill 会提前说明这些依赖和费用。

Skill 会不会做危险的事？ Skill 是一组指令，有些还带着会在本机运行的脚本。安装前先读 SKILL.md，并检查 scripts/ 里的文件。安装流程不应要求你粘贴 API Key 或密码。运行阶段若需要外部服务凭据，Skill 应明确说明用途，并指导你使用安全的密钥保存方式。

应该安装多少个？ 只安装真正会用的，长期不用的就删掉。数量少、边界清楚，通常更容易稳定触发。

如何更新？ 用新版本替换旧文件夹，再打开一个新会话。若 Skill 提供更新记录，替换前先看看改了什么。

下一步

现在已经知道 Skill 是什么，可以继续安装你的第一个 Skill，整个过程通常只需要几分钟。

全部指南