skill-manager

スキルマネージャー

Claude、Codex、Agents の各ランタイムにまたがるスキルエコシステムを管理する統合ツールです。

利用可能なコマンド

リポジトリの scripts/ ディレクトリにある skill-manager.sh スクリプトを使って、次のコマンドを実行します。

# Full audit — runs all checks in one pass
~/.claude/scripts/skill-manager.sh report

# Individual commands
~/.claude/scripts/skill-manager.sh usage          # Show skill usage frequency
~/.claude/scripts/skill-manager.sh usage --top 10  # Top 10 most-used skills
~/.claude/scripts/skill-manager.sh dupes           # Detect redundant/duplicate skills
~/.claude/scripts/skill-manager.sh check           # Verify availability for Claude/Codex/Agents
~/.claude/scripts/skill-manager.sh sync            # Validate repo sync status
~/.claude/scripts/skill-manager.sh update          # Check for npx skill updates
~/.claude/scripts/skill-manager.sh prune           # List candidates for removal

各コマンドを実行するタイミング

コマンド	使用するタイミング
report	定期的な全体の健全性チェック（毎週または毎月）
usage	削除候補を整理する前 — 実際に使用されているスキルを確認します
dupes	新しいスキルのインストール後 — 重複がないか確認します
check	setup.sh の実行後、またはスキルが見つからないように見えるとき
sync	スキルの編集後 — すべてがリンクされていることを確認します
update	定期的に — npx でインストールしたスキルに新しいバージョンがないか確認します
prune	スキル一覧が肥大化していると感じたとき — 削除候補を見つけます

使用状況の追跡方法

settings.json の PostToolUse フックは、Skill ツールが使用されるたびに実行され、次の情報を記録します。

• スキル名
• タイムスタンプ（UTC）
• プロジェクトディレクトリ

データは ~/.claude/skill-usage.jsonl に保存されます（1 行につき JSON オブジェクト 1 つ）。usage コマンドと prune コマンドは、このデータを読み込んでレポートを生成します。

このスキルの使い方

ユーザーからスキル管理について尋ねられたら、適切なコマンドを実行して結果を提示します。一般的な質問には、全体像を把握するために report を実行します。

結果の解釈

• Check：緑は適切にリンクされていることを示します。黄色は予期しない状態があることを示します。赤は壊れていることを示します。
• Sync：3 つのランタイム（Claude、Codex、Agents）すべてが、リポジトリの skills ディレクトリを参照していることを確認します。
• Dupes：スキルをプレフィックスでグループ化し、説明文のキーワードの重複を確認します。重複率が高い（>40%）場合は、統合を検討してください。
• Usage：呼び出し回数と最終使用日を表示します。「未使用」のスキルは削除候補です。
• Prune：使用状況データと重複分析を組み合わせて、削除候補を提案します。

スキルのアーカイブ

スキルをアーカイブする（アクティブな使用から除外しつつ、参照用に残す）には、次のコマンドを実行します。

mv skills/<name> ~/.claude/skills-archive/

この操作により、3 つのランタイムすべてからスキルが削除されます（各ランタイムはリポジトリの skills/ にシンボリックリンクされているためです）。