Agent Skills 规范速查表
SKILL.md frontmatter、目录结构、验证规则与平台路径的快速参考。
Updated 2026-06-22
agentskills.io 规范快速参考。
必填 frontmatter
---
name: my-skill-name
description: 做什么以及 Agent 何时应使用（20-1024 字符）
---
命名规则
- 仅小写字母、数字与连字符 - 必须与目录名一致 - 最多 64 字符
可选目录
- `scripts/` — Python、JS、Bash 可执行文件 - `references/` — 按需加载的 Markdown、JSON、YAML 文档 - `assets/` — 模板、图片、静态文件
FAQ
SKILL.md 有哪些必填字段？
必填 YAML 字段为 name（小写连字符）和 description（20-1024 字符，说明技能做什么及何时使用）。正文为 markdown 指令。