UStackUStack
skills-janitor icon

skills-janitor

skills-janitorでClaude Codeのスキルを監査・使用状況を追跡し、9つの/コマンドと比較。重複や不備もチェック。依存なし。

skills-janitor

skills-janitorとは?

skills-janitorは、Claude Code用のプラグインで、ユーザーのClaude Codeスキルを監査、使用状況を追跡、比較します。スキルセットを整理し、重複を特定、エラーや欠落情報をチェック、実際に呼び出しているスキルを要約する目的です。

9つの専用アクションで構成され、それぞれスラッシュコマンドとしてオートコンプリート付きで公開。GitHubでインストール用スキルを検索したり、類似スキルを比較する機能も備えています。

主な機能

  • 9つの監査アクションを個別スキル/コマンドとして公開: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search, /janitor-compare。
  • スキルごとのオートコンプリート: 各アクションが独立したスラッシュコマンドで、Claude Code UI内で利用可能な機能を簡単に発見。
  • 会話履歴からの使用状況追跡: 会話履歴を解析し、呼び出したスキルと未使用のスキルを表示。
  • 整合性チェックとクリーンアップワークフロー: スキルにエラー/欠落情報をチェックするコマンドと、壊れたスキルを削除(破壊的操作はdry-runプレビュー優先)。
  • 重複検出: 実質的に同じ機能の重複スキルを検出。
  • GitHubでのスキル発見と比較: キーワードでGitHubを検索し、自分のスキルと類似スキルを比較。

skills-janitorの使い方

  1. プラグインをインストール(ドキュメントの方法の1つ):
    • Claude Codeマーケットプレイスからkhendzel/skills-janitorを追加、または
    • リポジトリを~/.claude/skills/skills-janitorに直接クローン。
  2. スラッシュ構文でコマンドを実行。プロジェクトの例:
    • 在庫: /janitor-audit
    • 使用状況: /janitor-usage
    • 検索: /janitor-search
    • 比較: /janitor-compare
    • 検証: /janitor-check
    • 自動修正(プレビュー優先): /janitor-fix
  3. 自然言語でキーワードを使用(オプション)。スキル説明のキーワードでトリガー(例: “audit my skills”, “which skills do I use?”, “search for n8n skills”, “compare my-skill against alternatives”)。
  4. 変更前にdry-run出力を確認。破壊的操作はデフォルトでdry-runを使用し、明示的な確認なしに削除しません。

ユースケース

  • 月次スキル衛生管理: /janitor-reportと/janitor-cleanupでインストールスキルのフルレポートを生成し、問題、重複、欠落情報を特定。
  • 未使用スキルの発見: /janitor-usageで積極使用スキルと未呼び出しスキルを確認し、削除を決定。
  • 冗長性の削減: /janitor-duplicatesで同一機能のスキルを特定し、スキルセットを統合。
  • 詳細欠落スキルのデバッグ: /janitor-checkでエラー/欠落を検出後、/janitor-fix(デフォルトdry-run)で変更をプレビュー。
  • 新スキルの発見と比較: /janitor-searchでGitHubを検索、/janitor-compareで代替を評価し、インストール/更新前にスキルライブラリを管理。

FAQ

  • skills-janitorはスキルを自動削除しますか? プロジェクトは明示的な確認なしに何も削除しませんと明記。

  • 破壊的操作は即時適用されますか? リポジトリは破壊的操作をデフォルトでdry-runと明記。

  • マーケットプレイスやプラグイン提供スキルを変更しますか? プラグイン/マーケットプレイススキルを変更しませんと明記。

  • 使用状況レポートは何に依存? 会話履歴を解析し、呼び出したスキルと未使用スキルを判定。

  • プラグイン実行に必要なローカル環境は? 必要要件はBash, Python 3, curl(リポジトリはpipインストールなしnodeモジュールなしと記載)。

代替案

  • Claude Codeでの手動スキル管理: インストール済みスキルをレビューして選択的に削除・更新し、整理する;シンプルだが構造化インベントリ、重複検出、使用サマリーが欠如。
  • 汎用GitHub検索 + README比較: GitHubでスキルを検索し、リポジトリを自分で比較;発見と比較には使えるが、プラグインの使用追跡やビルトイン健全性チェックは提供されない。
  • 他のClaude Codeスキル管理ツール(カテゴリ代替): スキルの整理・検証・一覧に特化したツール;使用アナリティクス、重複検出、GitHubベースの発見の強調度が異なる場合あり。
  • カスタムCLIを使ったスクリプト監査: ~/.claude/skillsディレクトリをスキャンするローカルスクリプトを構築・使用;自動化は可能だが、プラグインの/コマンドワークフロよりセットアップが必要。
skills-janitor | UStack