技能审查器

技能简介

skill-reviewer 用于审查和审计智能体技能（SKILL.md 文件），从结构完整性、描述质量、元数据规范、内容组织、示例密度与质量、跨平台准确性、可操作性等维度进行系统化评估，输出评分和改进建议。

能做什么

• 验证 YAML frontmatter 结构是否完整（name、description、metadata 等字段）
• 审计 description 字段的清晰度、触发短语、关键词覆盖和长度合理性
• 检查 metadata 中的 emoji 相关性、依赖工具准确性和操作系统兼容性声明
• 统计代码示例密度，评估示例的语言标签、语法正确性、现实值使用和自包含性
• 分析章节组织是否按任务场景排列，常见操作是否优先展示
• 识别跨平台差异标注（macOS/Linux/Windows）和工具版本假设
• 判断指令是否可执行（祈使句、步骤明确、无歧义占位符）

使用说明

安装要求：需 Node.js 环境，通过 npx 运行。

1. 克隆或下载目标 SKILL.md 文件
2. 在终端执行：npx skill-reviewer ./path/to/SKILL.md
3. 根据输出的结构化检查清单逐项核对
4. 查看评分结果和改进建议，修复标记的缺陷

输入与输出

见下方输入与输出表格。

风险提示

• 审查结果依赖静态分析，无法检测运行时逻辑错误
• 评分标准偏向通用最佳实践，特定领域特殊需求可能未被覆盖
• 跨平台检查需人工复核实际执行环境差异
• 代码示例的语法正确性不保证功能完备性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gitgoodordietrying/skill-reviewer/SKILL.md
来源类型：GitHub 仓库