用途:帮助创建或改进简短、聚焦的 Agent Skills,适用于撰写或修订 SKILL.md、其 description 及配套文件;不适用于其他场景(资料原文在此处截断,后续内容暂未提供)。
核心理念:技能只是给能力足够的智能体一个方向提示,而非流程手册;只写下智能体自己不会做好的内容,其余交给其判断。
元数据规范:name 用小写 kebab-case,并与目录名一致。description 承担全部路由功能,因为正文只有在激活后才会加载;格式为「[做什么]。Use this skill when [触发条件]。Do not use for [近似但不适用的情况]。」,长度需小于 1024 字符。
正文规范:一个技能只做一件事,篇幅远低于 500 词。用平实句子或短要点说明要点及其原因,删去智能体默认就会做的事情。仅在破坏性、涉及安全或脆弱操作等出错代价高的地方规定确切步骤。不要为流程而流程:不添加清单、停止条件、标签体系、报告文件、评审循环或使用子智能体的指令。不处理冷门边缘情况;逐条质疑规则是否真能防止实际且可能发生的错误,否则删除。只有材料确实庞大或可复用时才添加 references/、assets/ 或 scripts/,并说明每个文件的用途。引用其他技能时只用名称,不要写其文件路径。
完成流程:在本仓库运行 node scripts/validate-skill-metadata.mjs <skill> 与 node scripts/validate-skill-links.mjs <skill>;接着在真实任务上试用一次该技能,并修复实际出现的问题。
限制:资料未说明支持的平台、收费情况或具体适用范围,暂未提供。