| 注册会员 | 172 |
| 主题 | 47 |
| 回复 | 7 |
| 节点 | 134 |
| 模型 | 1982 |
| 新用户 | 2 |
| 新主题 | 1 |
本文描述 Agent Skills 的完整格式规范，与 agentskills.io 开放标准一致。
一个 skill 是一个目录，至少包含一个 SKILL.md 文件：
skill-name/
└── SKILL.md # 必需可选的子目录包括 scripts/、references/、assets/，用于存放可执行脚本、参考文档和模板等资源。
SKILL.md 由 YAML 前置元数据（frontmatter）和 Markdown 正文组成，二者用 --- 分隔。
顶部必须包含以下两个字段：
---
name: skill-name
description: 本技能做什么、何时使用，简要说明。
---字段说明：
| 字段 | 是否必需 | 约束 |
|---|---|---|
name |
是 | 最多 64 字符。仅小写字母、数字与连字符；不能以连字符开头或结尾；不能出现连续连字符。必须与父目录名一致。 |
description |
是 | 最多 1024 字符，非空。描述技能用途与适用场景，建议包含便于发现阶段匹配的关键词。 |
license |
否 | 许可证名称或对包内许可证文件的引用。 |
compatibility |
否 | 最多 500 字符。环境要求说明（如目标产品、系统依赖、网络需求等）。 |
metadata |
否 | 任意键值对，如 author、version 等扩展属性。 |
必填的 name 用于发现与识别，且必须与技能包所在目录名一致。示例：目录为 pdf-processing 时，frontmatter 中应为 name: pdf-processing。
合法示例：
name: pdf-processing非法示例：
name: PDF-Processing # 含大写
name: -pdf-processing # 以连字符开头
name: pdf--processing # 连续连字符frontmatter 之后的 Markdown 内容为技能的实际指令，结构由作者自定（标题、列表、代码块等均可），无格式上的额外限制。助手在激活该技能时会将该正文读入上下文并按要求执行。
除 SKILL.md 外，技能包可包含以下子目录（均为可选）：
scripts/ — 可执行脚本，供助手在需要时调用。references/ — 参考文档，可在 SKILL.md 中引用。assets/ — 模板、静态资源等。完整示例结构见 什么是 Skills？· 技能包目录结构。
完整规范与校验工具见 agentskills.io；示例技能与参考库见 GitHub。
← 返回技能包文档 · 什么是 Skills？ · 概览