Skylv Skill Quality Assurance

通过 Node 脚本读取技能目录中的 SKILL.md，从清晰度、完整性、可执行性、可发现性和示例五个维度打分，按 A/B/C/F 分级输出质量报告与改进建议，并依据 ClawHub 发布阈值判断是否达标。

sky-lv

热度 40.91

最近更新 2026-05-11 17:44:10

分类：开发依赖：代码执行 / 读写文件应用场景：报告撰写

安装技能

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

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

Metadata

name: skylv-skill-quality-assurance
description: Analyzes and scores OpenClaw skill quality across 5 dimensions. Detects missing frontmatter, weak descriptions, poor examples, and actionable improvement recommendations.
keywords: skill, quality, analysis, scoring, improvement, documentation, review
triggers: quality, score, analyze skill, skill review, documentation

Skill Quality Assurance

Automatically analyze and score OpenClaw skill documentation quality. Identifies critical issues and provides actionable fixes.

Overview

This skill runs a multi-dimensional quality analysis on any OpenClaw skill's SKILL.md file, scoring it across:

Clarity — Structure, headings, sentence length
Completeness — Required fields, install/usage sections
Actionability — Step-by-step guides, commands
Discoverability — Keywords, description, categories
Examples — Code examples, before/after, use cases

Usage

Analyze a single skill

Analyze the skill at: C:\path\to\skills\my-skill

Analyze all skills in a directory

Run: node engine.js C:\path\to\skills

Interpretation

Score	Grade	Meaning
8-10	A	Production-ready
6-7	B	Needs minor improvements
4-5	C	Needs significant work
<4	F	Rewrite recommended

Scoring Dimensions

1. Clarity (20%)

Checks for: headings hierarchy, sentence length, filler words, markdown formatting

2. Completeness (20%)

Checks for: name, description, keywords, install section, usage section

3. Actionability (25%)

Checks for: numbered steps, runnable commands, configuration guides

4. Discoverability (15%)

Checks for: keywords (5+), description length (50+ chars), category/tags

5. Examples (20%)

Checks for: code blocks (3+), before/after cases, use case descriptions

Quality Thresholds

For ClawHub publication:

Overall score ≥ 7.0 required
No dimension below 5.0
Must have keywords field
Must have description ≥ 50 chars

Auto-Fix

The companion script fix_skill_md.cjs automatically fixes:

Missing description field
Missing keywords field
Missing Install section
Missing Usage section

node fix_skill_md.cjs

Example Output

# Skill Quality Report

Analyzed: 34 skills

## Overall Rankings
 1. ✅ skylv-browser-automation-agent   9.4/10
 2. ✅ skylv-openclaw-evomap-connector   9.3/10

Average score: 8.1/10
Grade A (7+): 29
Grade B (5-6): 5
Grade C (<5): 0