Skill Quality Assurance
OpenClawスキルのドキュメント品質を自動分析・評価します。重大な問題を特定し、改善策を提示します。
概要
このスキルは、任意のOpenClawスキルのSKILL.mdファイルに対して多面的な品質分析を実行し、以下の各次元でスコアリングします。
- 明瞭性 — 構造、見出し、文章の長さ
- 完全性 — 必須項目、インストール/使用セクション
- 実行可能性 — ステップバイステップガイド、コマンド
- 発見容易性 — キーワード、説明、カテゴリ
- 具体例 — コード例、Before/After、ユースケース
使用方法
単一スキルの分析
次のスキルを分析してください: C:\path\to\skills\my-skill
ディレクトリ内の全スキルを分析
node engine.js C:\path\to\skills
スコアの解釈
| スコア | グレード | 意味 |
|---|---|---|
| 8-10 | A | プロダクション対応 |
| 6-7 | B | 軽微な改善が必要 |
| 4-5 | C | 大幅な改善が必要 |
| <4 | F | 書き直しを推奨 |
評価次元
1. 明瞭性 (20%)
チェック項目: 見出しの階層、文章の長さ、冗長な表現、Markdown書式
2. 完全性 (20%)
チェック項目: name、description、keywords、インストールセクション、使用セクション
3. 実行可能性 (25%)
チェック項目: 番号付き手順、実行可能なコマンド、設定ガイド
4. 発見容易性 (15%)
チェック項目: キーワード数(5以上)、説明文字数(50文字以上)、カテゴリ/タグ
5. 具体例 (20%)
チェック項目: コードブロック数(3以上)、Before/After例、ユースケース説明
品質基準
ClawHub公開条件:
- 総合スコア 7.0以上
- 各次元 5.0未満なし
keywordsフィールド必須descriptionが50文字以上
自動修正
付属スクリプト fix_skill_md.cjs が以下の項目を自動修正します:
descriptionフィールドの欠落keywordsフィールドの欠落Installセクションの欠落Usageセクションの欠落
node fix_skill_md.cjs
出力例
# スキル品質レポート
分析対象: 34 スキル
## 全体ランキング
1. ✅ skylv-browser-automation-agent 9.4/10
2. ✅ skylv-openclaw-evomap-connector 9.3/10
平均スコア: 8.1/10
グレードA (7+): 29
グレードB (5-6): 5
グレードC (<5): 0