skill-quality-check は何をしますか？
AIエージェントスキル向け品質監査ツール。5次元スコアリングフレームワークを使用して、任意のSKILL.mdをClaudeのベストプラクティスに照らして監査します。
概要
このスキルは、AIエージェントスキルのSKILL.mdファイルを読み込み、定義された品質基準に基づいてスコアリングします。5次元のフレームワークは以下の項目を評価します：
- 明確性 (Clarity) - スキルの目的、使用方法、制約が明確に文書化されているか
- 一貫性 (Consistency) - 命名規則、フォーマット、スタイルが一貫しているか
- 完全性 (Completeness) - 必要なセクション（説明、使用例、制約など）がすべて含まれているか
- 実用性 (Practicality) - スキルが実際のユースケースで有用か、具体例が十分か
- 保守性 (Maintainability) - ドキュメントが更新しやすく、将来的な変更に対応できるか
使用方法
# SKILL.mdファイルを監査する
audit path/to/SKILL.md
出力例
=== 品質監査結果 ===
スキル: webkong/example-skill
総合スコア: 8.2/10
各次元のスコア:
- 明確性: 8.5/10
- 一貫性: 7.8/10
- 完全性: 9.0/10
- 実用性: 8.0/10
- 保守性: 7.5/10
改善提案:
- 一貫性: 用語「アシスタント」と「エージェント」の使い分けを統一してください。
- 保守性: 更新履歴セクションを追加することを検討してください。
スコアリングフレームワーク
各次元は以下の基準でスコアリングされます：
| スコア範囲 | 評価 | 意味 |
|---|---|---|
| 9-10 | 優良 | ベストプラクティスに完全に準拠 |
| 7-8 | 良好 | ほとんど準拠、軽微な改善余地あり |
| 5-6 | 普通 | 基本的な要件を満たす、改善が必要 |
| 0-4 | 不十分 | 大幅な改善が必要 |
プラットフォーム互換性
このスキルは以下のAIエージェントプラットフォームで使用できます：
- Claude Code
- Cursor
- Codex CLI
- その他のSKILL.md互換環境
カスタマイズ
環境変数を使用して評価基準を調整できます：
SKILL_QUALITY_THRESHOLD- 合格しきい値（デフォルト: 7.0）SKILL_QUALITY_DIMENSIONS- 評価する次元のカンマ区切りリスト
開発者向け情報
ローカルでのテスト
# リポジトリをクローン
git clone https://github.com/webkong/skill-quality-check.git
cd skill-quality-check
# 依存関係をインストール
pip install -r requirements.txt
# テストを実行
pytest
貢献
バグ報告や機能リクエストは、GitHub Issues までお願いします。プルリクエストも歓迎します。
ライセンス
MIT