
2025年10月Anthropic 推出 Agent Skills，它是既 MCP 后 Anthropic 推出的又一个 Agent 领域的行业标准（见 [agentskills.io](https://agentskills.io)）。Cursor、Claude、Codex 等兼容该标准的 Agent，都能按同样的目录约定发现并使用 Skill。
# 一、 Agent Skill入门
## 1.1  Agent Skill 到底是什么？

 **Agent Skill（智能体技能）** 是一项开放标准，用于为 AI 智能体扩展专业能力。技能将特定领域的知识和工作流打包，使智能体能够执行特定任务。是一套独立、可移植、可版本管理的说明包，封装流程知识+业务专属上下文，用来教会 AI Agent 如何完成某一类**领域任务**。 

通俗比喻：
- **Agent（智能体）= 通用员工，头脑聪明，但不懂你们公司内部办事流程、规范**
- **Skill = 一份标准化 SOP 操作手册（附带模板、规则、边界约束），需要干活时拿出来照着执行**

![image.png](https://developer.qcloudimg.com/http-save/yehe-9980940/f2ba90df45c5e9548008f291ff152195.png)

## 1.2 Agent Skill长什么样？

### 1.2.1 文件架构
从核心构成来看，一个Skill就是一个文件夹，其中包含 `SKILL.md` 文件。该文件存放元数据（至少包含名称与描述）以及指令，用于告知智能体如何执行特定任务。Skill还可以附上脚本、参考资料、模板以及其他各类资源。
```txt
my-skill/
├── SKILL.md           # 必选：元数据 + 给 Agent 的操作说明
├── scripts/           # 可选：可执行代码
├── references/        # 可选：按需加载的详细文档
├── assets/            # 可选：模板、配置样例等静态资源
└── ...                # 任何额外文件或目录
```
### 1.2.2 SKILL.md文件格式
```markdown
---
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
![image.png](https://developer.qcloudimg.com/http-save/yehe-9980940/c331d950c0e80cf36f0ff6b29c6f9412.png)

![image.png](https://developer.qcloudimg.com/http-save/yehe-9980940/977868164488a537a684ff10b4f140d9.png) 


# 二、怎么用Agent Skill？
## 2.1 安装Agent
可以安装如下Agent产品软件：
| 产品和模型的名称 | 公司 | 地区 | 类别 | 底层模型 | 备注 |
| --- | --- | --- | --- | --- | --- |
| `CodeBuddy` | 腾讯云 | 国内 | 编程 | 混元 + DeepSeek | 推荐 |
| `Qoder` | 阿里 | 国内 | 编程 | Qwen，部分档可路由 | 推荐 |
| `Trae `| 字节跳动 | 国内 | 编程 | 豆包 + 常有 Claude / GPT / DeepSeek | |
| `智谱 ZCode` | 智谱 AI | 国内 | 编程 | GLM |  |
| `DeepSeek Harness` | DeepSeek | 国内 | 编程 | DeepSeek（V4 等），可外挂其他模型 |  |
| `Cursor` | Cursor / Anysphere | 国外 | 编程 | Claude / GPT / Gemini / Grok 等多模型 |推荐 |
| `Claude Code` | Anthropic | 国外 | 编程 | 仅 Claude（Opus / Sonnet） | 容易被封号 |
| `OpenAI Codex` | OpenAI | 国外 | 编程 | GPT / Codex 编程档 | |
| `GitHub Copilot` | Microsoft / GitHub | 国外 | 编程 | GPT 为主，企业档可混 Claude | |
| `Gemini CLI / Code Assist` | Google | 国外 | 编程 | Gemini |  |


## 2.2 获取Skill
日常能用到的 Skill，大致来源如下
| 来源 | 谁提供 | 典型用途 | 是否建议进仓库 |
|------|--------|----------|----------------|
| 个人编写 | 自己 | 个人习惯、跨项目私货 | 可选；常放用户目录 |
| 团队仓库 | 项目 / 组织 | 团队 SOP、发版、规范 | **是**（首选） |
| 远程安装 | GitHub / 插件 / 远程 Rule | 复用社区或他组现成包 | 评审后再引入 |

### 1. 产品内置
各 Agent 产品通常会预装一批通用 Skill，打开就能用，无需另行安装。
以 **Cursor** 为例：自带一批通用 Skill，出现在 `/` 菜单里，例如：
| Skill | 用途 |
|-------|------|
| `/create-skill` | 创建新的 Agent Skill |
| `/create-rule` | 创建 Cursor Rules |
### 2. 官方网站
 [Agent Skills 开放标准 ](https://agentskills.io) 
 [Anthropics官方Skills 仓库](https://github.com/anthropics/skills) 
 可以下载下来 文件夹放入自己的Skill文件夹中，即可使用
 ![image.png](https://developer.qcloudimg.com/http-save/yehe-9980940/048d07e05fe12f5a4a91037bf14ce498.png)
 
### 3. Skills社区网站 
| 站点 | 链接 | 特点 |
|------|------|------|
| skills.sh | [skills.sh](https://skills.sh) | 偏 CLI / 注册表风格，体量大 |
| SkillsMP | [skillsmp.com](https://skillsmp.com) | 从公开 GitHub 聚合，目录极广 |
| Skillselion | [skillselion.com](https://skillselion.com) | Skills / MCP / Marketplace 索引，可按安装量浏览 |
| AgenticSkills | [agenticskills.io](https://agenticskills.io) | 偏精选目录，常与 MCP 一起陈列 |
|awesome-claude-skills|https://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` 一致，例如：

```txt
.cursor/skills/pr-review/
└── SKILL.md          # name: pr-revie
```
### 2.触发方式
#### 自动触发（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 消耗。
![image.png](https://developer.qcloudimg.com/http-save/yehe-9980940/f7cb88db2d790402d0352a6b04c92f69.png)
### 1. 发现阶段（Discovery，启动时）

1. Cursor 扫描项目级、全局级 `skills` 目录，遍历每个技能文件夹读取 `SKILL.md` 的**头部 YAML 元数据**（`name`、`description`）。

2. 仅把**技能名称 + 简短描述**注入 Agent 系统提示词，只生成一份 “技能目录”。

>每个技能仅消耗约 100token，大量技能也不会爆上下文。
❗**不会读取 SKILL.md 完整步骤、脚本、参考文档**。

### 2. 触发阶段（Activation，用户提问后）
两种触发方式：
1. **手动触发**：聊天框输入 `/xxx`，直接指定技能。
2. **自动触发**：Agent 理解用户意图，和技能`description`做语义匹配，判断当前任务适合该 Skill。

匹配成功，Agent 调用内部工具`load_skill`。
### 3. 加载阶段（Load）
运行时读取磁盘上完整的`SKILL.md`，把完整工作步骤、约束、模板，作为**系统合成消息注入对话上下文**（用户界面不可见）。

- 按需读取附属资源：`references/`参考文档、`assets/`模板；

- 按需执行捆绑脚本：`scripts/`下脚本文件；

- 未命中的技能依旧只保留元数据，不占用 token。

### 4. 执行阶段（Execution）

Agent 按照 SKILL.md 写好的步骤，调用底层原子 Tools（读文件、改代码、运行终端、搜索仓库），走 ReAct 循环完成多步骤任务；任务结束，Skill 完整指令不再常驻本轮之后的对话。
>Skill = 编排流程；Tool = 原子动作。Skill 告诉 Agent**先做什么、后做什么、边界约束**；Tool 真正干活（读写文件、命令行）。

Cursor 启动时，会自动从技能目录中发现技能，并将其提供给 Agent 使用。智能体会看到可用的技能，并根据上下文判断何时适用。
你也可以在 智能体聊天 中输入 `/`，然后搜索技能名称以手动调用技能

# 四、编写自己的Agent Skill
## 4.1 什么时候该写 Skill？

适合写成 Skill 的场景：
- 同一套流程要反复执行（发版、评审、建表、写周报）
- 需要统一团队约定（命名、目录、验收标准）
- 需要「带上下文的 SOP」（业务规则、门禁、禁止事项）
- 希望跨 Cursor / Claude / 其他兼容 Agent **一处维护、多处使用**

不太适合硬塞进 Skill 的：
- 一次性临时问题（直接对话即可）
- 纯工具连通能力（优先做 MCP / CLI，再由 Skill 编排「怎么用工具」）
## 4.2 怎么写
参考1.2.2 SKILL.md文件格式

### 新建一个文件夹
Skill的目录名必须与 `SKILL.md` 里的 `name` 一致
### 元数据部分
被短横线包起来
name：技能的名称
description：Skill的描述，向大模型说明这个Skill是做什么的
```请在此输入代码块语言
---
name: 会议总结助手
description: 该技能用于根据会议录音总结内容
---
```
### Body content 指令部分
说明模型需要遵循的规则



2025年10月Anthropic 推出 Agent Skills，它是既 MCP 后 Anthropic 推出的又一个 Agent 领域的行业标准（见 agentskills.io）。Cursor、Claude、Codex 等兼容该标准的 Agent，都能按同样的目录约定发现并使用 Skill。

Agent Skill 完全指南：让 AI 智能体"一次学会，处处复用"

Agent Skill 是 2025 年继 MCP 之后的下一项开放标准：把领域流程打成可版本管理的说明书，而不是再训练一个模型。一个文件夹、一份 SKILL.md，兼容 Agent 写一次就能多端复用。加载靠渐进式披露——会话只看见名字，命中才读正文，细节随执行再展开。MCP 回答「能调用什么」，Skill 回答「该怎么做」。本指南覆盖获取、存放、触发与手写清单。

人工智能

2025年10月Anthropic推出的AgentSkills开放标准，正成为继MCP后Agent领域的行业新标杆。该标准通过SKILL.md文件定义可移植、可版本管理的技能包，采用渐进式披露机制控制Token消耗。Cursor、Claude Code等主流Agent均兼容此标准，支持自动触发和手动触发两种调用方式。本文从文件架构、安装部署、触发机制到编写实践，完整解析了AgentSkills的落地方法。

安全审计

代码解释

智能体

CodeBuddy

DeepSeek

路由

GitHub

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

2025年10月Anthropic推出的AgentSkills开放标准，正成为继MCP后Agent领域的行业新标杆。该标准通过SKILL.md文件定义可移植、可版本管理的技能包，采用渐进式披露机制控制Token消耗。Cursor、Claude Code等主流Agent均兼容此标准，支持自动触发和手动触发两种调用方式。本...

Agent Skill 完全指南：让 AI 智能体"一次学会，处处复用"-腾讯云开发者社区-腾讯云

Agent Skill 完全指南：让 AI 智能体"一次学会，处处复用"

Agent Skill 完全指南：让 AI 智能体"一次学会，处处复用"

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐