用途:帮助 SME 在发布 Agent Skill 前完成审查,覆盖环境确认、依赖校验、结构验证、内容审查、可选 LLM 评分与结果解读。
主要能力:读取 ~/.config/skill-validator/review-state.yaml 复用已保存配置;选择完整审查或仅结构审查;检查 skill-validator 与 claude CLI 是否可用;运行 skill-validator check <path> 并按退出码判断结果(0 无问题、1 有错误需修复、2 仅警告、3 命令用法错误);读取 SKILL.md 及引用文件,检查示例、边界情况、范围门控,以及涉及 MongoDB 数据访问时是否要求使用 MCP server;可选按 references/llm-scoring.md 运行并解读 LLM 评分;最后按结构验证、SKILL.md 评分、引用文件评分、新颖性评估、行动项、发布建议的顺序输出摘要。
使用方式:按步骤执行。先确认环境,再验证依赖(skill-validator --version 需不低于 v1.5.1,否则用 brew upgrade skill-validator 或 go install github.com/agent-ecosystem/skill-validator/cmd/skill-validator@latest 升级;启用 LLM 评分时需 claude --version,macOS 可用 curl -fsSL https://claude.ai/install.sh | bash 安装并交互式登录)。随后定位含 SKILL.md 的技能目录,运行结构校验,进行内容审查,按需运行 LLM 评分,最后汇总结果。
适用场景:Agent Skill 发布前的质量把关,尤其适合需要结构合规与内容质量双重检查的团队。
限制:结构校验退出码为 1 时不得继续 LLM 评分;内容审查项不阻塞发布但建议修复;LLM 评分依赖 Claude CLI 与认证;未提供具体评分维度阈值之外的细节,部分引用文件内容暂未提供。