用途:帮助用户新建一个智能体技能(agent skill),覆盖从需求收集到成稿的完整流程,并规定技能应具备的结构与描述写法。
主要能力与流程:一是收集需求,了解技能覆盖的任务或领域、要处理的具体用例、是否需要可执行脚本还是仅需说明、是否需要附带参考资料;二是起草技能,产出 SKILL.md 简明说明,内容超过 100 行时另建参考文件,需要确定性操作时加入工具脚本;三是与用户复核草稿,确认是否覆盖用例、是否有遗漏或不清、某部分是否需要更详细或更精简。
结构与描述要求:技能目录建议为 skill-name/ 下含 SKILL.md(必需)、REFERENCE.md(按需)、EXAMPLES.md(按需)与 scripts/(按需,如 helper.js)。SKILL.md 使用带 name、description 的头部元数据。description 是智能体决定加载哪个技能时唯一能看到的内容,会与其他已安装技能一起出现在系统提示中,因此最长 1024 字符、用第三人称书写,第一句说明做什么,第二句写“Use when [specific triggers]”,并包含具体关键词、上下文或文件类型。
何时加脚本与拆分文件:操作确定(校验、格式化)、同一代码会被反复生成、需要显式处理错误时加脚本;SKILL.md 超过 100 行、内容分属不同领域、高级功能很少用到时拆分文件。
复核清单:描述含触发条件、SKILL.md 少于 100 行、不含时效性信息、术语一致、含具体示例、引用只深入一层。
限制:资料未提供该技能的安装方式、收费与价格、平台支持、实际效果等信息;上述流程与规范为编写技能的方法说明,不保证特定执行环境下的行为。