目录一、 Agent Skill入门1.1 Agent Skill 到底是什么1.2 Agent Skill长什么样1.2.1 文件架构1.2.2 SKILL.md文件格式(1) Frontmatter字段(2) Body content1.2.3 Skill Demo二、怎么用Agent Skill2.1 安装Agent2.2 获取Skill1. 产品内置2. 官方网站3. Skills社区网站4. 个人编写5. 团队仓库2.4 Skill的使用1. Skill存放到指定位置2.触发方式自动触发Ambient手动触发Slash文件范围触发paths / 嵌套目录三、Agent Skill的工作原理1. 发现阶段Discovery启动时2. 触发阶段Activation用户提问后3. 加载阶段Load4. 执行阶段Execution四、编写自己的Agent Skill4.1 什么时候该写 Skill4.2 怎么写新建一个文件夹元数据部分Body content 指令部分概述Agent Skill 是 2025 年继 MCP 之后的下一项开放标准把领域流程打成可版本管理的说明书而不是再训练一个模型。一个文件夹、一份 SKILL.md兼容 Agent 写一次就能多端复用。加载靠渐进式披露——会话只看见名字命中才读正文细节随执行再展开。MCP 回答「能调用什么」Skill 回答「该怎么做」。本指南覆盖获取、存放、触发与手写清单。2025年10月Anthropic 推出 Agent Skills它是既 MCP 后 Anthropic 推出的又一个 Agent 领域的行业标准见 agentskills.io。Cursor、Claude、Codex 等兼容该标准的 Agent都能按同样的目录约定发现并使用 Skill。一、 Agent Skill入门1.1 Agent Skill 到底是什么Agent Skill智能体技能是一项开放标准用于为 AI 智能体扩展专业能力。技能将特定领域的知识和工作流打包使智能体能够执行特定任务。是一套独立、可移植、可版本管理的说明包封装流程知识业务专属上下文用来教会 AI Agent 如何完成某一类领域任务。通俗比喻Agent智能体 通用员工头脑聪明但不懂你们公司内部办事流程、规范Skill 一份标准化 SOP 操作手册附带模板、规则、边界约束需要干活时拿出来照着执行1.2 Agent Skill长什么样1.2.1 文件架构从核心构成来看一个Skill就是一个文件夹其中包含SKILL.md文件。该文件存放元数据至少包含名称与描述以及指令用于告知智能体如何执行特定任务。Skill还可以附上脚本、参考资料、模板以及其他各类资源。my-skill/ ├── SKILL.md # 必选元数据 给 Agent 的操作说明 ├── scripts/ # 可选可执行代码 ├── references/ # 可选按需加载的详细文档 ├── assets/ # 可选模板、配置样例等静态资源 └── ... # 任何额外文件或目录1.2.2 SKILL.md文件格式--- name: my-skill description: 简短说明此技能的功能及使用场景。 --- # 我的技能 为代理提供的详细说明。 ## 何时使用 - 在...情况下使用此技能 - 此技能在...方面有帮助 ## 说明 - 为代理提供的逐步指导 - 特定领域的约定 - 最佳实践和模式 - 如果需要向用户澄清需求请使用“询问问题”工具(1) Frontmatter字段字段必填描述name是技能标识符。最多64个字符只能包含小写字母、数字和连字符。连字符不能在开始和结尾位置必须与父文件夹名称一致。description是最多1024个字符不能为空。描述该技能的功能及适用时机。智能体据此判断相关性。license否许可证名称或对随包附带许可证文件的引用metadata否用于存储额外元数据的任意键值映射。(2) Body content前置元数据frontmatter之后的 Markdown 正文存放技能指令。格式不作限制编写一切能够帮助智能体高效完成任务的内容即可推荐编写以下章节Step‑by‑step instructions 分步执行指令Examples of inputs and outputs 输入输出示例Common edge cases 常见边界场景1.2.3 Skill Demo一个真实的飞书文档Skill demo二、怎么用Agent Skill2.1 安装Agent可以安装如下Agent产品软件产品和模型的名称公司地区类别底层模型备注CodeBuddy腾讯云国内编程混元 DeepSeek推荐Qoder阿里国内编程Qwen部分档可路由推荐Trae字节跳动国内编程豆包 常有 Claude GPT DeepSeek智谱 ZCode智谱 AI国内编程GLMDeepSeek HarnessDeepSeek国内编程DeepSeekV4 等可外挂其他模型CursorCursor / Anysphere国外编程Claude GPT Gemini / Grok 等多模型推荐Claude CodeAnthropic国外编程仅 ClaudeOpus / Sonnet容易被封号OpenAI CodexOpenAI国外编程GPT / Codex 编程档GitHub CopilotMicrosoft / GitHub国外编程GPT 为主企业档可混 ClaudeGemini CLI / Code AssistGoogle国外编程Gemini2.2 获取Skill日常能用到的 Skill大致来源如下来源谁提供典型用途是否建议进仓库个人编写自己个人习惯、跨项目私货可选常放用户目录团队仓库项目 / 组织团队 SOP、发版、规范是首选远程安装GitHub 插件 远程 Rule复用社区或他组现成包评审后再引入1. 产品内置各 Agent 产品通常会预装一批通用 Skill打开就能用无需另行安装。以Cursor为例自带一批通用 Skill出现在/菜单里例如Skill用途/create-skill创建新的 Agent Skill/create-rule创建 Cursor Rules2. 官方网站Agent Skills 开放标准Anthropics官方Skills 仓库可以下载下来 文件夹放入自己的Skill文件夹中即可使用3. Skills社区网站站点链接特点skills.shskills.sh偏 CLI / 注册表风格体量大SkillsMPskillsmp.com从公开 GitHub 聚合目录极广Skillselionskillselion.comSkills MCP Marketplace 索引可按安装量浏览AgenticSkillsagenticskills.io偏精选目录常与 MCP 一起陈列awesome-claude-skillshttps://github.com/ComposioHQ/awesome-claude-skills精选Skills使用建议社区包质量参差多数未经人工安全审计。下载后先读SKILL.md与scripts/确认无敏感操作、无不明外联再拷入个人或项目目录不要盲装进生产仓库。4. 个人编写把个人习惯、跨项目私货写成 Skill放在用户级目录Cursor 下为~/.cursor/skills/name/。适合个人 commit 风格、本地快捷流程、暂时不想进团队仓库的实验稿。可用产品内置的/create-skill引导创建写完后用自然语言或/技能名自测触发。5. 团队仓库把团队 SOP、发版、评审、测试规范写成项目 Skill放进仓库Cursor 下为.cursor/skills/name/随 Git 共享。这是组织内落地的首选人人同一套流程可评审、可版本管理、可 Code Review。2.4 Skill的使用1. Skill存放到指定位置兼容 Agent Skills 标准的产品通常按「作用范围」分目录存放。以 Cursor 为例Skill的类型路径作用范围说明项目 Skill.cursor/skills/skill-name/当前仓库团队首选随 Git 共享人人一致个人 Skill~/.cursor/skills/skill-name/本机所有项目个人习惯、跨项目私货产品内置~/.cursor/skills-cursor/由 Cursor 维护禁止手写升级会被覆盖注意Skill的目录名必须与SKILL.md里的name一致例如.cursor/skills/pr-review/ └── SKILL.md # name: pr-revie2.触发方式自动触发Ambient正常下指令即可例如「按我们仓库的规范给这个 PR 做评审」。Agent 若发现某个 Skill 的description匹配就会自行加载并遵循。适合高频、安全、描述写得很准的流程。手动触发Slash在 Agent 输入框打/搜索并选择 Skill例如/commit-helper、/babysit。这会强制把该 Skill 装入上下文。适合你想确定「这次一定走这套流程」Skill 设置了disable-model-invocation: true描述容易和别的任务混淆时文件范围触发paths / 嵌套目录给 Skill 配paths: **/*.tsx或把 Skill 放在apps/web/.cursor/skills/下——只有工作触及相关文件时它才更容易出现减少无关干扰。三、Agent Skill的工作原理核心机制渐进式披露Progressive Disclosure不会把全部技能全部塞进上下文只先加载摘要匹配任务才加载完整指令控制 Token 消耗。1. 发现阶段Discovery启动时Cursor 扫描项目级、全局级skills目录遍历每个技能文件夹读取SKILL.md的头部 YAML 元数据name、description。仅把技能名称 简短描述注入 Agent 系统提示词只生成一份 “技能目录”。每个技能仅消耗约 100token大量技能也不会爆上下文。❗不会读取 SKILL.md 完整步骤、脚本、参考文档。2. 触发阶段Activation用户提问后两种触发方式手动触发聊天框输入/xxx直接指定技能。自动触发Agent 理解用户意图和技能description做语义匹配判断当前任务适合该 Skill。匹配成功Agent 调用内部工具load_skill。3. 加载阶段Load运行时读取磁盘上完整的SKILL.md把完整工作步骤、约束、模板作为系统合成消息注入对话上下文用户界面不可见。按需读取附属资源references/参考文档、assets/模板按需执行捆绑脚本scripts/下脚本文件未命中的技能依旧只保留元数据不占用 token。4. 执行阶段ExecutionAgent 按照 SKILL.md 写好的步骤调用底层原子 Tools读文件、改代码、运行终端、搜索仓库走 ReAct 循环完成多步骤任务任务结束Skill 完整指令不再常驻本轮之后的对话。Skill 编排流程Tool 原子动作。Skill 告诉 Agent先做什么、后做什么、边界约束Tool 真正干活读写文件、命令行。Cursor 启动时会自动从技能目录中发现技能并将其提供给 Agent 使用。智能体会看到可用的技能并根据上下文判断何时适用。你也可以在 智能体聊天 中输入/然后搜索技能名称以手动调用技能四、编写自己的Agent Skill4.1 什么时候该写 Skill适合写成 Skill 的场景同一套流程要反复执行发版、评审、建表、写周报需要统一团队约定命名、目录、验收标准需要「带上下文的 SOP」业务规则、门禁、禁止事项希望跨 Cursor Claude 其他兼容 Agent一处维护、多处使用不太适合硬塞进 Skill 的一次性临时问题直接对话即可纯工具连通能力优先做 MCP / CLI再由 Skill 编排「怎么用工具」4.2 怎么写参考1.2.2 SKILL.md文件格式新建一个文件夹Skill的目录名必须与SKILL.md里的name一致元数据部分被短横线包起来name技能的名称descriptionSkill的描述向大模型说明这个Skill是做什么的--- name: 会议总结助手 description: 该技能用于根据会议录音总结内容 ---Body content 指令部分说明模型需要遵循的规则