mcpField
J
janitor-value

janitor-value

github.com/khendzelエージェントワークフロー12251 回インストール4 週間前に更新
リポジトリ

janitor-value について

janitor-value は、Claude Code 向けにインストール済み Skill のコンテキストトークンコストと最近の利用状況を集計します。常時読み込まれる説明と必要時に読み込まれる本文を分け、コストの高い未使用 Skill を見つけられます。

主な機能

  1. 01説明と本文のトークンを分離
  2. 02最近の Skill 呼び出しを追跡
  3. 03未使用 Skill をコスト順に表示
  4. 04期間と予算を指定
  5. 05表または JSON で出力

活用シーン

  1. 01コストが高く未使用の Skill の特定
  2. 02指定期間での Skill 利用状況の比較
  3. 03コンテキスト予算に対する常時読み込みトークンの確認

MCP 対応

関連する MCP レポートスクリプトは設定済み MCP サーバーを調べ、セッショントランスクリプトから呼び出し回数、使用ツール数、最終利用日を報告します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/khendzel/skills-janitor --skill janitor-value

インストール後、Claude Code で/janitor-valueを入力して読み込まれたか確認します。

詳細

スキル価値レポート

インストール済みの各スキルが、消費するコンテキストウィンドウトークンに見合う価値を生み出しているかを確認します。

概要

トークンコストと使用状況の追跡を一つのビューにまとめ、インストール済みのすべてのスキルを未使用コストが大きい順に表示します。各スキルのコストを、常時読み込まれる部分（説明）と必要に応じて読み込まれる部分（本文）に分けたうえで、最近の呼び出し状況と照合し、使われていないスキルを確認できます。

v1.2 の /janitor-tokens（コストのみ）と /janitor-usage（使用状況のみ）の分割を置き換えます。

前提条件

  • skills-janitor プラグインがインストールされた Claude Code（scripts/value.sh を提供）
  • bash 3.2 以降（標準の macOS bash で動作します。外部依存関係はありません）
  • ~/.claude/skills、~/.claude/agents、Claude Code のローカルセッション履歴への読み取りアクセス
  • 認証情報や API キーは不要です。スクリプトはローカルファイルのみを読み取ります。

手順

ステップ 1：価値計算スクリプトを実行する
bash ~/.claude/skills/skills-janitor/scripts/value.sh [--weeks N] [--budget N] [--json]
  • --weeks N — 使用状況を調べる期間（デフォルト：4）
  • --budget N — ％計算に使用するコンテキストウィンドウのサイズ（デフォルト：200000）
  • --json — 生の JSON を出力
ステップ 2：結果を提示する

表と概要をユーザーに提示します。結果を説明する際、本文のトークンを常時読み込まれるコンテキストコストとして説明してはいけません。常時読み込まれるのは説明のみです。プラグイン名前空間付きのスキルは、完全な呼び出し名で表示されます（例：marketing-skills:image、figma:figma-use）。

ステップ 3：無駄が大きい場合は対処方法を提案する

「未使用スキルのコスト」が予算の 20% を超える場合は、完全なヘルスチェックのために /janitor-report を実行するか、（v1.4 以降では）対話形式で仕分けするために /janitor-swipe を実行するよう提案します。

出力

インストール済みのすべてのスキルを含む表：

  • Always — 説明のトークン数。システムプロンプトに常時読み込まれるコスト（実際のコンテキスト使用料）
  • Body — SKILL.md の残りの部分。スキルが呼び出されたときにのみ読み込まれます（段階的な開示）
  • Used? — 調査期間内に呼び出されていれば yes、それ以外は NO
  • Last Used — 最も最近の呼び出し日

続いて概要：

  • コンテキストに読み込まれたトークンの合計（常時読み込みの TOTAL にはスキルと ~/.claude/agents のサブエージェントの説明が含まれ、予算に対する割合として表示されます）
  • 使用中と未使用の内訳
  • 無駄の大きいスキル：使用回数がゼロで、コストの高いスキル

エラー処理

  1. エラー：value.sh: No such file or directory 解決策：プラグインが別のルートにインストールされています。ls ~/.claude/skills で場所を確認するか、プラグインキャッシュを調べてから、実際の場所にあるスクリプトを実行してください。

  2. エラー：すべてのスキルで Used? 列が NO と表示される 解決策：調査期間が短すぎるか、セッション履歴が空の可能性があります。たとえば --weeks 12 のように、期間を延ばして再実行してください。

  3. エラー：スキルのトークン数が 0 と表示される 解決策：そのスキルの SKILL.md が存在しないか、読み取れません。/janitor-report を実行して問題のあるスキルを特定し、/janitor-fix --prune で整理してください。

  4. エラー：デフォルト以外のモデルで、パーセンテージが正しくないように見える 解決策：たとえば --budget 500000 のように、正しいコンテキストサイズを明示して指定してください。

例

例 1：標準的な価値チェック

入力：「スキルはトークンコストに見合っていますか？」

出力：bash ~/.claude/skills/skills-janitor/scripts/value.sh を実行し、無駄の大きい順に並べた表と概要の行を提示します。例：「常時読み込みの合計：8,420 トークン（200k の予算の 4.2%）。31 個のスキルのうち 6 個が 4 週間未使用です。最も無駄の大きいスキル：heavy-skill（1,900 トークン、未使用）。」

例 2：調査期間を延長し、カスタム予算を設定する

入力：「過去四半期のスキル使用状況を、500k のウィンドウを基準に確認してください。」

出力：bash ~/.claude/skills/skills-janitor/scripts/value.sh --weeks 12 --budget 500000 を実行し、調整後の調査期間とパーセンテージを反映した同じ表を提示します。

例 3：機械可読な出力

入力：「スキル価値の生データをください。」

出力：--json を付けてスクリプトを実行し、JSON ペイロードを変更せずに返します。

MCP サーバー（v1.7）

コンテキストコストにおける MCP 側の状況を確認するには、bash {baseDir}/../../scripts/mcp.sh [--weeks N] を実行します。設定済みのすべてのサーバー（ユーザー、プロジェクト、プラグイン）を、セッショントランスクリプトから取得した実際の呼び出し回数とともに一覧表示し、指定した期間内に使用されていないサーバーも表示します。トークン数を推測することはありません。スキーマはサーバー側にあるため、janitor は呼び出し回数、使用された個別のツール数、最終使用日時を代わりに報告します。

リソース

  • レポートスクリプト（プラグイン相対パス）：{baseDir}/../../scripts/value.sh
  • /janitor-report — 重複や壊れたスキルを含む、完全なヘルスチェック
  • /janitor-fix --prune — 壊れたシンボリックリンクと空のスキルディレクトリを削除
  • /janitor-discover — 新しいスキルを見つける、またはインストール前にスキルを確認

コメント

Markdown 対応