如果你已经用过Claude Code、Cursor或Codex CLI一段时间，大概会遇到这种情况：功能都正常，但网上总有人讨论"agent skills"，你却不清楚这到底是什么、从哪里入手。这篇文章就是为你准备的。
什么是Agent Skill？
Agent skill是一个markdown文件，用来教你的AI编程助手如何处理特定类型的任务。可以把它想象成你交给新员工的详细操作手册——不用每次都口头解释部署流程，写一次，agent需要时自己读。
技能文件存放在名为SKILL.md的文件中。文件顶部是YAML frontmatter（包含name、description等元数据字段），下面是普通markdown格式的结构化指令。这个格式由Agent Skills Specification定义，这是Anthropic最初开发、现由社区管理的开放标准。
安装技能时，实际上就是把包含SKILL.md文件的文件夹放到agent知道去查找的位置。有些技能只有一个文件，有些则附带模板、配置文件或脚本等支持资源。
如何安装
安装过程很直接，基本流程如下：
找到技能仓库。大多数技能托管在GitHub上，克隆或下载仓库。
将技能文件夹复制到agent的技能目录。Claude Code通常是项目根目录下的.claude/skills/，Cursor则是.cursor/skills/。每个agent有自己的约定，需查阅对应文档。
重启agent会话或重新加载技能。有些agent自动识别新技能，有些需要重启。
部分技能包包含安装程序。Antigravity Awesome Skills这个社区集合收录了1,464个SKILL.md playbook，提供npm安装程序自动将技能放到正确位置。
如果希望超越手动安装，iFlytek的SkillHub相当于agent技能的npm registry。它提供用于发布和安装的CLI，还有Web UI和RBAC功能，适合团队管理技能。
SKILL.md格式详解
每个技能遵循相同的基本结构。以下是最小化示例：
---
name: my-deploy-skill
description: "Deploys the current project to staging"
allowed-tools:
- Bash
- Write
---
# Deploy to Staging
## When to use
When the user asks to deploy to staging.
## Steps
1. Run the test suite and confirm all pass.
2. Build the production bundle.
3. Push to the staging branch.
4. Monitor the deploy logs for errors.
## Constraints
- Never deploy if tests fail.
- Always ask before pushing to production.
frontmatter处理元数据，正文处理指令。该规范支持可选字段如compatibility（指定目标agent）、license，以及metadata用于自定义键值对。
一个重要细节：allowed-tools字段。它告诉agent运行该技能时允许使用哪些工具，既是权限边界也是提示。如果你的技能绝不应该触碰生产数据库，就在这里声明。
实际应用建议
从简单开始。先写一个处理单一任务的技能，比如"运行测试套件"或"格式化代码"。等熟悉格式后再构建复杂的工作流。
版本控制你的技能。把它们和代码放在一起，或者单独建个仓库。技能也是代码，应该被审查和测试。
考虑你的团队。如果多人使用相同技能，确保文档清晰，约束条件明确。SKILL.md中的模糊指令会导致agent行为不一致。
关注社区。Agent Skills Specification是开放标准，新工具和最佳实践持续涌现。GitHub上的技能仓库是了解他人如何解决类似问题的好途径。
技能系统本质上是在标准化"如何把领域知识教给AI"。过去每个项目都要重复解释技术栈的特殊之处，现在可以写成可复用的指令文件。对于需要维护多个代码库或频繁切换技术栈的开发者，这种可移植性节省的时间会迅速累积。
热门跟贴