用途:帮助用户创建新的 agent skill,产出结构规范、支持渐进式披露(progressive disclosure)并包含捆绑资源(bundled resources)的 skill。
创建流程:第一步收集需求,向用户确认 skill 覆盖的任务或领域、需处理的具体用例、是否需要可执行脚本而非仅说明、是否要纳入参考材料。第二步起草 skill,创建带简洁说明的 SKILL.md;内容超过 500 行时创建额外参考文件;需要确定性操作时创建工具脚本。第三步与用户复核草稿,确认用例覆盖、缺失或不清晰之处、哪些部分应更详细或更精简。
目录结构:skill-name/ 下包含 SKILL.md(必需主说明)、REFERENCE.md(详细文档,按需)、EXAMPLES.md(用法示例,按需)、scripts/(工具脚本,按需,如 helper.js)。
SKILL.md 模板含 name 与 description 的 frontmatter,正文分 Quick start(最小可用示例)、Workflows(复杂任务的步骤与清单)、Advanced features(链接到单独文件)。
description 要求:它是 agent 判断是否加载该 skill 时唯一可见的内容,会与其他已安装 skill 一起出现在系统提示中。应让 agent 知道该 skill 提供什么能力、何时及为何触发(特定关键词、上下文、文件类型)。格式最多 1024 字符,使用第三人称,首句说明做什么,第二句写“Use when [具体触发条件]”。示例:Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction. 反例“Helps with documents.”无法让 agent 区分其他文档类 skill。
何时添加脚本:操作具有确定性(校验、格式化)、同一段代码会被反复生成、错误需要明确处理时。相比生成代码,脚本更省 token 且更可靠。
何时拆分文件:SKILL.md 超过 100 行、内容涉及不同领域(如财务与销售 schema)、高级功能很少被使用时。
复核清单:description 含触发条件(“Use when...”);SKILL.md 低于 100 行;不含时效性信息;术语一致;包含具体示例;引用只深入一层。
限制:官方说明未提供收费、价格、平台等细节。