什么是 Agent Skills，它们如何工作？
Agent Skills 是存储为 SKILL.md 文件的模块化指令包，赋予 AI 编码代理专业能力。安装后，代理在会话开始时仅读取名称和描述。当与您的任务相关时，完整指令按需加载 — 这是一种延迟加载设计，即使安装了数十个也能保持 Token 使用效率。
完整指南Agent Skills 详解
什么是 Agent Skills？
理解 Agent Skills 的权威指南 — 它们是什么、如何工作、开发者为什么使用它们，以及如何开始使用开放的 SKILL.md 标准。从基础到高级用法全面解析 Agent Skills。
无论您是第一次询问"什么是 Agent Skills"，还是希望加深专业知识，本指南涵盖了关于驱动 14+ AI 编码工具的开放 SKILL.md 标准所需了解的一切。
Agent Skills 定义
那么 Agent Skills 到底是什么？Agent Skills 是模块化、可复用的指令、工作流和领域知识包，赋予 AI 编码代理专业能力。每个技能都存储为包含必需 SKILL.md 文件的目录，该文件包含 YAML 前置元数据（如名称、描述和标签等元数据）以及告诉代理在技能激活时如何行为的 Markdown 指令。这种方法将 AI 编码助手从通用工具转变为领域专家。
与单次会话后消失的一次性提示不同，Agent Skills 在每次对话中持续存在。一旦安装，代理会识别技能何时相关并自动加载 — 无需手动激活。这种持久性正是使它们与临时提示根本不同的地方。您只需编码一次最佳实践，它们就会每次可靠地应用。
它们的范围可以从简单的单文件指令到包含多个子技能、参考文档、模板甚至辅助脚本的综合集合。该格式故意设计为基于文本且人类可读 — 任何能写 Markdown 的人都能创建一个。这种低准入门槛推动了生态系统的快速增长，目前社区存储库中已有数十万个可用。
Agent Skills 的工作原理
在底层，Agent Skills 遵循为 Token 效率设计的延迟加载架构。当会话开始时，AI 代理仅从每个已安装技能中读取前置元数据 — 通常只有名称、描述和标签。此元数据索引消耗的 Token 非常少，因此您可以安装数十个而不会有任何明显的性能影响。
当代理确定某个特定技能与当前任务相关时（基于元数据匹配），它会按需加载完整的指令正文。这种按需激活意味着技能仅在实际需要时才消耗 Token。替代方案 — 将所有指令塞入系统提示 — 会很快耗尽上下文窗口。
SKILL.md 格式是 Agent Skills 工作原理的核心。典型文件以指定技能名称、简短描述、版本和可选标签的 YAML 前置元数据开始。在前置元数据下方，Markdown 部分包含详细的指令、规则、示例和工作流。一些高级技能还在同一目录中包含伴随文件 — 模板、配置片段或参考文档。
因为它们是纯文本文件，技能与版本控制自然集成。Agent skills md 格式（SKILL.md）通常被称为 Agent Skills 标准 — 每个兼容工具都能理解的单一、开放规范。团队将其 Agent skills md 文件与源代码一起提交，通过拉取请求跟踪更改，像审查任何其他项目文件一样审查更新。这使它们成为首个真正的开发者原生方法来自定义 AI 编码助手。
Agent Skills 的历史
Agent Skills 的概念起源于 Anthropic，他们在 2025 年为 Claude Code 创建了 SKILL.md 格式。这个想法解决了 AI 编码工作流中的空白：开发者在各个会话中反复输入相同的指令，而且没有标准化的方式来打包和共享这些指令。SKILL.md 格式通过引入代理可以自动发现和加载的基于文件的方法来解决此问题。
该格式迅速在 Claude Code 之外获得关注。OpenAI 在 2025 年底为 Codex CLI 采用了该标准，认识到共享、开放格式的价值。此后不久，GitHub 将 Agent Skills 集成到 Copilot 中，Cursor、Windsurf 和 Gemini CLI 等工具也纷纷跟进。到 2026 年初，SKILL.md 标准已被 14+ AI 编码工具采用 — 这是 AI 开发生态系统中前所未有的跨工具互操作性水平。
如今，该格式被认为是 AI 编码堆栈中的基础层。它与 Model Context Protocol (MCP) 一起，是扩展 AI 代理能力的两种主要方式之一。MCP 将代理连接到外部系统，而技能提供告诉代理如何完成任务的程序性知识。竞争平台之间的快速采用表明，行业将其视为必要的基础设施，而非专有功能。
Agent Skills vs 提示
与传统提示进行比较时，什么是 Agent Skills 就变得更加清晰。它们有时被称为代理技能，因为它们赋能代理工作流，代表着相对于临时提示的重大改进。
| 方面 | Agent Skills | 临时提示 |
|---|---|---|
| 持久性 | 跨会话持续 — 安装一次，永久使用 | 每次会话后丢失，需要重新输入 |
| 可复用性 | 在项目和团队间完全可复用 | 在会话间复制粘贴，容易偏移 |
| 可共享性 | 通过 Git、ZIP 或市场共享 | 通过文档或聊天非正式共享 |
| 版本控制 | Git 跟踪，有完整历史 | 无版本控制 |
| Token 效率 | 按需延迟加载 | 每次都消耗 Token |
| 跨平台 | 通过 SKILL.md 在 14+ 工具中工作 | 工具特定，不可移植 |
简而言之，Agent Skills 将短暂的提示知识转化为持久的、可移植的资产。采用它们的团队报告通过消除重复的指令编写，每位开发者每周节省 2-3 小时。
Agent Skills vs MCP
Agent Skills 和 MCP 是互补技术，而非竞争对手。技能提供程序性知识 — 通过分步指令、编码标准和工作流定义教代理如何执行任务。MCP 提供工具连接性 — 使代理能够访问数据库、API 和服务等外部系统。
这样理解：技能是操作手册，MCP 是工具包。部署技能可能定义如何部署应用程序（工作流、安全检查和回滚程序），而 MCP 服务器提供与云基础设施的实际连接。大多数团队同时使用两者以获得最大效果。
一个关键的实际差异是设置复杂性。Agent Skills 不需要服务器 — 只需将 SKILL.md 文件放入正确的目录即可。MCP 需要运行服务器进程并配置 JSON-RPC 连接。技能也更具可移植性：一个文件在所有兼容平台上工作，而 MCP 服务器实现可能因工具而异。
有关它们与 MCP 比较的全面分析，以及为什么许多开发者认为它们同样具有变革性，请阅读我们的详细文章：Agent Skills: A Bigger Deal Than MCP?
Agent Skills vs 插件
传统 IDE 插件和技能解决相关问题，但方式根本不同。IDE 插件是连接到特定编辑器 API 的编译扩展 — 创建需要编程知识，绑定到单一平台，且每当宿主编辑器更改 API 时都需要更新。相比之下，技能是在支持 SKILL.md 标准的所有工具中工作的纯文本 Markdown 文件。
这种基于文本的简单性是核心优势。任何能写 Markdown 的人都能创建 Agent Skill — 无需 SDK，无需构建步骤，无需平台特定代码。它们也极其轻量：典型技能只有几千字节的文本，而插件可能是数兆字节的编译代码。因为通过自然语言指令而非 API 绑定来运作，它们本质上更灵活且更容易更新。
权衡是它们无法访问低级编辑器 API（语法高亮、自定义 UI 面板、快捷键绑定）。但对于绝大多数 AI 辅助开发工作流 — 代码生成、测试、审查、文档、部署 — 技能提供了所需的一切，而无需传统插件开发的开销。随着生态系统的成熟，这种轻量级方法正在证明其重大优势。
Agent Skills 的类型
Agent Skills 生态系统覆盖软件开发生命周期中的广泛用例。以下是您在探索 Agent Skills 目录时会找到的主要类别。
谁在使用 Agent Skills？
开始使用 Agent Skills
现在您了解了什么是 Agent Skills，这里是在日常工作流中开始使用的分步指南。
1
浏览 Agent Skills 市场
首先探索 Agent Skills 市场，发现与您工作流匹配的技能。按类别、平台或用例筛选。每个列表包含描述、预览、兼容性信息和下载按钮。
2
下载并安装
将所需技能下载为 ZIP 文件。对于 Claude Code，解压到 ~/.claude/skills/。对于 Codex CLI，放在 .codex/skills/ 中。对于其他工具，将 SKILL.md 文件复制到工具的 skills 目录。代理在下次会话启动时自动发现和索引。
3
自然使用
安装后无需明确激活。像平常一样工作即可。当您的任务匹配已安装的技能时，代理会自动加载并应用编码的指令。您会立即注意到更一致、更高质量的输出，符合技能定义的最佳实践。
4
探索开源存储库
除了市场之外，GitHub 上还有数千个社区创建的技能。访问我们的 Agent Skills GitHub 页面获取最佳存储库的精选列表。您也可以在 GitHub 上直接搜索 SKILL.md 文件，发现其他开发者创建的技能。
5
创建您自己的 Agent Skills
熟悉现有技能后，开始创建您自己的 Agent Skills。任何您频繁重复的工作流都是候选。创建包含 SKILL.md 文件的目录，定义前置元数据，并编写清晰的 Markdown 指令。与团队共享或通过 Agent Skills 市场发布到社区。
关于 Agent Skills 的常见问题
Agent Skills 的跨平台兼容性如何？
Agent Skills 使用开放的 SKILL.md 标准，该标准受 14+ AI 编码工具支持，包括 Claude Code、Codex CLI、ChatGPT、GitHub Copilot、Cursor、Windsurf 和 Gemini CLI。一个 SKILL.md 文件无需转换即可在所有兼容平台上工作。这种跨平台兼容性是相对于专有插件系统的核心优势。
Agent Skills 是免费的吗？
是的。Claude Skills Hub 上的所有 Agent Skills 都是免费和开源的，以 MIT 和 Apache 2.0 等宽松许可证发布。您可以在个人和商业项目中免费使用。SKILL.md 标准本身是开放的，因此任何人都可以自由创建、共享和分发。
Agent Skills 最适合什么用途？
Agent Skills 擅长编码可重复的工作流、编码标准、测试模式、安全检查清单和领域特定知识。它们最适合您经常执行的任务 — 代码审查、测试生成、API 设计、文档和部署自动化。任何您向 AI 代理解释超过一次的工作流都是成为技能的候选。
探索更多 Agent Skills 资源
现在您知道了什么是 Agent Skills，深入了解生态系统。通过这些资源浏览、搜索和发现。
Stay Updated with Claude Skills
Subscribe to get the latest Claude Skills, tutorials, and community highlights delivered to your inbox.
We respect your privacy. Unsubscribe at any time.