skill-quality-checker

该 Skill 通过 Python 脚本对已安装的 skills 目录或单个 skill 做静态扫描，按问题-方案匹配度、完成度、容错性、Description 精度、Token 效率五个维度各 20 分打分，输出 markdown 或 JSON 评分报告与改进建议。脚本仅用 Python 标准库，评分为启发式静态分析，供参考。

shaozhengmao

热度 52.81

最近更新 2026-05-11 17:30:57

分类：开发依赖：代码执行 / 读写文件应用场景：代码审查 / 报告撰写 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skill-quality-checker

Metadata

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.

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)

工作流程

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

注意事项

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