skill-review 用于按 Agent Skills 标准与汇编的最佳实践审查、校验智能体技能。
用途:当用户要求审查或校验某个 skill、正在创建新 skill 并希望获得反馈、询问“这个 skill 写得好吗”,或提到 skill 质量、最佳实践、改进时使用。
主要能力:审查结构、frontmatter、description 质量、渐进式披露与常见反模式。流程分阶段:先读取 references/best-practices.md 与 references/checklist.md;再确定审查对象(单个 skill 的 SKILL.md 及其结构、整个 skills/ 目录,或创建前的新草稿);随后做结构审计(SKILL.md 是否存在、目录名与 frontmatter 中 name 是否一致、引用是否仅一层、脚本是否使用正斜杠、是否有多余文件如 README.md 或 CHANGELOG.md、脚本路径是否真实存在、外部依赖是否记录);接着校验 YAML frontmatter(name 仅含小写字母、数字与连字符,≤64 字符,不含 anthropic 或 claude;description 非空、≤1024 字符、第三人称、同时说明做什么与何时触发、含具体触发短语);评估 description 质量(具体动作、触发短语、用户可能使用的同义词,避免含糊或缺少触发条件);分析正文(行数是否在 500 行以内、渐进式披露、token 效率、自由度设置、是否提供默认值);检查反模式(Windows 路径、嵌套引用、时间敏感信息、魔数、无默认值的多选项、术语不一致、面向用户的文档、第一/第二人称);最后按固定格式输出报告,包含摘要、结构、frontmatter、description 质量、正文分析、发现的反模式与建议。
使用方式:按上述阶段执行。需要快速校验时,可走“快速审查模式”,对照 references/checklist.md 只报告未通过项。
限制:资料未提供安装命令、运行环境、价格或平台信息;其审查依据来自 references/best-practices.md 与 references/checklist.md,上述细节以资料为准。