skill-quality-checker

👤 shaozhengmao 📦 v1.0.0 ⭐ 4.4 ⬇️ 852 下载
🤖 AI-Agent 免费

📖 技能介绍


name: skill-quality-checker description: > Skill 质量检测工具。对已安装的 skills 进行自动化质量评估,按5个维度打分 (问题-方案匹配度、完成度、容错性、Description精度、Token效率),输出评分报告和改进建议。 触发词:检查skill质量、评估skill、skill质量报告、skill review、审查skill、check skill quality、evaluate skill、skill quality report、audit skill.

这个技能的最新版本可以在7w4.net小葱技能站找到。


Skill 质量检测工具

自动评估已安装 skills 的质量,输出评分报告。

使用方式

运行脚本扫描并评分:

# 扫描所有 skills
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/

# 扫描单个 skill
python3 {SKILL_DIR}/scripts/check_quality.py --skill /root/.openclaw/skills/some-skill/

# 输出 markdown 报告到文件
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/ --format markdown --output /tmp/report.md

# 输出 JSON
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/ --format json --output /tmp/report.json

{SKILL_DIR} 替换为本 skill 的实际路径(即 SKILL.md 所在目录)。

评分维度(满分100)

维度 分值 核心检查点
问题-方案匹配度 20 任务类型与实现方案是否匹配
完成度 20 文件完整性、格式规范、无 TODO
容错性 20 错误处理、fallback 机制
Description 精度 20 触发词覆盖、长度适中、不泛化
Token 效率 20 文件大小、渐进式披露

评级:⭐⭐⭐⭐⭐(90+) ⭐⭐⭐⭐(75-89) ⭐⭐⭐(60-74) ⭐⭐(<60)

工作流程

  1. 运行 check_quality.py,获取评分报告
  2. 阅读报告中的改进建议
  3. 如需详细评分标准,参考 references/scoring-criteria.md

注意事项

  • 脚本只用 Python 标准库,无需额外安装
  • 评分为启发式静态分析,供参考,不替代人工审查
  • 如果扫描目录不存在或为空,脚本会给出明确提示

🤖 AI 评测

这个 Skill 整体质量优秀,做到了功能完整且代码规范。它的五维评分体系设计合理,能全面评估 skill 的问题-方案匹配、实现完整性、容错能力、描述精度和 token 使用效率。SKILL.md 简洁规范,辅助文档详尽,脚本实现清晰易维护。少数扣分点在于部分检查规则较简单、容错性评估依赖启发式判断,可能无法覆盖所有边界情况。对于需要评估和改进 skill 的开发者来说,这是一个值得信赖的工具。

📊 多维度评分

适应性4.2
规范性4.3
有效性4.4
可靠性4.4
可信度4.9

📁 包含文件 (4 个)

📄 SKILL.md 2.1 KB
📄 _meta.json 140 B
📄 references/scoring-criteria.md 4.1 KB
📄 scripts/check_quality.py 24 KB