skill-auditor について
Skill Auditorは、グローバル、プロジェクト、プラグインの各場所にあるClaudeスキルを監査するスキルです。サイズやメタデータを一覧化し、選択したスキルについて簡潔さ、明確さ、重複、構成を詳しく確認します。
主な機能
- 013つの場所からスキルを検出
- 02メタデータと行数の集計
- 03サイズと状態による並べ替え
- 04簡潔さ、明確さ、重複の確認
- 05所見と改善優先度の報告
活用シーン
- 01行数制限を超えたスキルの特定
- 02詳細レビュー対象となる大型スキルの選定
- 03スキル整理作業の優先順位付け
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill skill-auditorインストール後、Claude Code で/skill-auditorを入力して読み込まれたか確認します。
詳細
スキル監査
ワークフロー
ステップ 1:すべてのスキルを検出する
以下の場所をスキャンして、SKILL.md ファイルを探します。
| レベル | パス |
|---|---|
| グローバル | ~/.claude/skills/*/SKILL.md |
| プロジェクト | .claude/skills/*/SKILL.md |
| プラグイン | plugins/*/skills/*/SKILL.md |
見つかった各スキルについて、以下を収集します。
- 名前:フロントマターの
name:フィールドから取得します(なければディレクトリ名を使用します) - レベル:グローバル/プロジェクト/プラグイン(プラグインのスキルにはプラグイン名も含めます)
- 行数:
SKILL.mdの合計行数 - allowed-tools の有無:はい/いいえ
- 説明の長さ:
description:フィールドの文字数
ステップ 2:サマリー表を提示する
行数の降順で並べます。形式:
| # | Level | Plugin | Skill Name | Lines | Status |
ステータス表示:
OVER— 500 行の上限を超過HEAVY— 300~499 行(上限に近い)OK— 300 行未満
合計を記載します。
- レベルごとのスキル数
- 全スキルの合計行数
- スキルあたりの平均行数
- 上限を超過したスキル数
ステップ 3:ユーザーに選択を求める
AskUserQuestion を使用して、レビューするスキルを尋ねます。以下を提案します。
OVERまたはHEAVYのスキルすべて- 行数が最も多い上位 5 件
- プラグイン名でレビューするオプション
- 特定のレベルに属するすべてのスキルをレビューするオプション
ステップ 4:詳細レビュー(選択したスキルごと)
選択したスキルをそれぞれ最後まで読みます。以下の基準で評価します。
簡潔さ(トークン効率)
- LLM の動作に影響しない行(冗長な文章、帰属、ペルソナ)
- Claude がすでに理解している概念の重複した説明
- 短縮できる冗長な例
- CLAUDE.md のルールを繰り返しているセクション
明瞭さ
- 複数の解釈が可能な曖昧な指示
- Claude に推測を強いるコンテキストの不足
- スキル内で用語が一貫していない箇所
スコープの重複
- 同じレベルにある他のスキルと、対象範囲を比較します
- 内容が大幅に重複するスキルを指摘します
- 統合または分割の候補を特定します
構成
- フロントマターが完全か(name、description、allowed-tools)
- 説明の品質(短すぎると見つけにくく、長すぎると無駄になります)
- セクションの構成(マーケットプレイスの規約に準拠しているか)
ステップ 5:調査結果を報告する
レビューしたスキルごとに、以下を出力します。
## {skill-name} ({lines} lines)
**Verdict:** {TRIM | RESTRUCTURE | MERGE | OK}
**Issues:**
- [CONCISENESS] {specific finding with line reference}
- [CLARITY] {specific finding}
- [OVERLAP] overlaps with {other-skill}: {shared scope}
**Suggested savings:** ~{N} lines ({percentage}% reduction)
**Recommended actions:**
1. {specific action}
2. {specific action}
ステップ 6:まとめ
すべてのレビューの後、以下を提示します。
- 削減できる行数の合計
- 統合を推奨するスキル(理由を添えます)
- 改善の優先順位(トークン削減効果の高い順)
コメント
Markdown 対応