官方定义：一个 skill 是一个目录，内含一个必选的 SKILL.md 文件（YAML 元数据 + Markdown 指令），可按需捆绑脚本、参考文档与资源。它把「领域专业知识、流程与最佳实践」打包成可复用、可版本化的文件，让通用 Agent 变成某个领域的专家。Anthropic 官方用「给新人写的入职指南」来比喻它。
标准目录结构
- SKILL.md — 必选：frontmatter 元数据 + 指令正文。
- scripts/ — 可选：可执行代码（Python / Bash / JS 等）。
- references/ — 可选：按需加载进上下文的参考文档。
- assets/ — 可选：模板 / 图片 / 数据等产物文件。
frontmatter 关键约束
- name 必填：最长 64 字符，仅允许小写字母、数字与连字符，首尾与中间均不能出现连字符，且必须与所在目录同名。也保留「anthropic」「claude」等保留词限制。描述的是「做什么 + 何时用」。
- description 必填：最长 1024 字符，应包含能让模型识别任务是否相关的触发关键词。
- 可选字段：license（许可证）、compatibility（环境兼容）、metadata（自定义键值）、allowed-tools（预授权工具，实验性）等。
官方演进与采纳：Anthropic 于 2025-10-16 在官方博客正式发布 Agent Skills，2025-12-18 将其作为开放标准（open standard）发布到 agentskills.io。目前 Claude Code、OpenAI Codex / ChatGPT、Cursor、Gemini CLI、VS Code、Trae 等大量客户端都声明兼容该格式。
规模数据（学术研究）：2026 年的一项数据集工作（arxiv: GitSkills）在 2026 年 7 月从 GitHub 公开仓库抓取到约 380 万份 SKILL.md、分布于 28 万+ 仓库，去重后约 188 万份独立内容。这既说明格式已被大规模采用，也暴露出生态早期问题：没有统一注册中心或包管理器，技能主要靠「复制文件夹」在仓库间传播。