Agent Skills 是一种轻量级的开放格式，用于通过专业知识和工作流 AI 智能体的能力。

因为智能助手的能力日益提高，但往往缺乏可靠完成实际工作所需的上下文信息。技能模块通过赋予助手按需加载程序化知识及公司、团队和使用者专属上下文的能力，可以解决了这一问题。具备技能集的智能助手可根据当前任务动态 功能。

• 技能开发者的观点是。一次培养能力，即可部署至多个智能体产品。
• 兼容智能体这方面，技能支持让终端使用者开箱即可赋予智能体新能力。不过，
• 团队与公司这方面。将组织知识封装为可移植、版本控制的知识包。

什么是技能

简单说技能就是一个带 SKILL.md 文件的文件夹。

SKILL.md 里至少要有元数据（比如 name 和 description) 和执行指令，告诉智能体怎么干活。技能还可以附带脚本、模板、参考资料等。按理说，

├── SKILL.md # 必需：指令 + 元数据
├── scripts/ # 可选：可执行代码
├── references/ # 可选：文档资料
└── assets/ # 可选：模板、资源

技能是怎么工作的

技能用「渐进式披露」来管理上下文：

1. 发现: 启动时智能体只加载每个技能的名称和描述。够用就行——知道什么时候可能派得上用场。
2. 激活: 当任务跟技能描述匹配时智能体把完整的 SKILL.md
3. 执行: 智能体按指令干活，需要时可以加载引用的文件或执行脚本。怎么说呢，

这样既保证响应快。又能在需要时获取更多上下文。

SKILL.md 文件结构

从name来看。pdf-processing
description: 从 PDF 提取文本和表格，填写表单，合并文档
---
# PDF Processing
## 什么时候用
使用者需要处理 PDF 文件时用…## 怎么提取文本
用 pdfplumber 提取文本…## 怎么填表单，...

前置元数据

文件顶部必须有前置元数据：

name这方面。skill-name

description: 这个技能是干什么的，什么时候用…
...

完整字段示例

再看name，pdf-processing
description: 从 PDF 提取文本和表格，填写表单，合并文档
license: Apache
compatibility: Python +,requires pdfplumber,pymupdf
metadata:
author的观点是。example-org

version:
...

字段说明


字段说明表格示例 



name 是最多 字符。说起来，只能小写字母、数字、连字符，不得以连字符开头或；不能连续连字符，老实说，必须跟父目录名一致。

description 是最多 字符。不为空，要说清楚作用与场景，并包含关键词方便匹配。

是否许可证名称或许可证文件方法.

是否环境要求。


否任意键值对。用于添加额外元数据.

否技术预批准工具列表，以空格分隔。


Name 命名规则举例说明：


有效示例：   data-analysis
再看name，data-analysis
name的观点是，data-analysis
再看name，data-analysis
再看name，data-analysis
)`}`)`)" />`
`data-analysis` `data-analysis` `data-analysis` `data-analysis` `data-analysis`


'
`data-analysis`


`data-analysis`


'
`data-analysis`


`analysis`
**无效示例**：
**无效** 示例：
**无效** 示例：
**无效** 示例：

markdown
从name来看。skill-name
markdown
说到name，pdf-processing
description: 从 PDF 提取文本和表格，填写表单，合并文档
license: Apache
compatibility: Python +,requires pdfplumber,pymupdf
metadata:
从author来看，example-org
/\t ﹈ ​﹄ ﹈﹈﹈﹈﹈﹈輪輪輪輪輪輪輪律�\t 螢爨𪜃𪜂𪜀𪜀𪜁𪝇𪛄\x00\x00\x00\x00\x00\x00\x00\x0000000000000000000000000000049\u2025\u2025\u2025\u2025\u2025\u2025\ufffd\ufffd\ufffd\ufffd\ufffd\ufffd\ufffd\ufffd\ufffd\ufffd\ufff9\ufff9\f\f\f\f\f\f\"

"
/>

"
/>


字段<\/th>
必需<\/th>
说明<\/th>
<\/tr>
<\/ad>


name<\/td>
是<\/td>
最多 字符，可仅小写字母数字连字符；怎么说呢，不能以连字符开头或；不能连续连字符，说起来，必须跟父目录名一致。\u200B \u200B \u200B \u200B \u200B \u200B \u200B \u200B \u200B \u200B \u200B。<\/td>
<\/tr>

description<\/td>
是<\/td>
最多 字符。不得为空，要说清楚作用与场景，并包含关键词方便匹配。<\/td>
<\/tr>

license<\/td>
否<\/td>
是否许可证名称或许可证文件方法。<\/td>
<\/tr>

compatibility<\/td>
否\/\t\t\t\t\t\t\t\t\t\t\t\t 否 \/\t\t 否 否 否 \/\t 否 \t \/ \/ \/ \/ \t\u2018 \t \r，兼容性等信息。\r 等\r 等\r 等\r 等\r 等\r 等\r 等\r 〖\r 〖\r 〖\r 〖\r 〖\r 〖\r 〖





名称命名规则
text
- 长度符合限制
- 小写字母数字连字符。只允许 ASCII
- 不以 "-" 开头或
- 不含连续 "--"
- 与父目录名保持一致

有效示例
text
至于name，data-analysis

无效示例
text
- pdf # 开头为 "-" 的不合法
pdf--processing # 连续 "--" 的不合法


描述如何编写


必须非空且简明扼要。

明确指出何种情境下调用此技术。

建议加入关键词以便匹配。



指令内容建议结构


使用脚本


能让智能体执行 shell 命令，也可以把可复用脚本放在 scripts/ 下。




类型
用途




一次性命令
在指令里直接写 shell 命令


独立脚本
自身依赖代码放在 scripts/ 下


脚本接口设计
指定如何调用脚本还有传递参数





获取天气 Skills
使用高德地图 API 查询指定城市实时天气信息。按理说，至于项目目录结构。text
├── SKILL.md # 技能定义文件
└── wear.py # API查询文件

获取 API Key
访问高德开放网站申请 Web 服务 API Key。markdown
name : wear-skill
description : 通过高德地图 API 查询指定城市实时天气信息
license : Apache
metadata :
author : zhoupb
version : "."


功能描述
查询指定城市实时天气信息，包括温度、天气状况、风力风向等。其实，

使用方式
直接描述你要查询天气，例如：
- "天气怎么样"
- "今天气象"
- "现在多少度"

环境变量
请设置高德 API Key：
bash
export AMAP_MAPS_API_KEY=your_api_key

安装依赖
bash
pip install -r requirements.txt

使用方法
bash
python wear.py

示例输出
再看北京天气。晴温度：°C风力：级 北风湿度:%发布时间：
-- ::

API 说明
高德地图天⾃⾃⾃接口：
- 城市查询接口
- 天气查询接口
获取 API Key 请在相应网站申请。

wear.py 文件
python
城市天气查询 - 使用高德 API"""
import os,json,sys,requests,time
def get_city_code->str|None:
"""根据城市名获取城市代码"""
url = ""
params = {
再看"key"，api_key,"keywords": city_name,"subdistrict": "",}
resp = requests.get
resp.raise_for_status
data = resp.json
if data.get == "" and data.get:
return data
return None
def query_wear->dict|None:
"""查询城市天气"""
url = ""
params = {
再看"key"，api_key,"city": city_code,"extensions": "base"。}
resp = requests.get
resp.raise_for_status
data = resp.json
if data.get == "" and data.get:
return data
return None
def main:
if len <2:
        print
        print
        sys.exit
city_name=sys.argv
api_key=os.environ.get
if not api_key:
print
sys.exit
#


if name=="main":
main



官方 Skills 列表

官方提供多种 Skill 包括：


文档分析与转换类 Skill，例如 OCR 与 PDF 提取 Skill。

数据分析类 Skill，例如统计聚合与图形绘制 Skill。

云服务集成类 Skill，例如 AWS Lambda 调用 Skill。