k-skill-cleaner

ユーザーが K-skill バンドルを軽量化したい、使わないスキルを見つけたい、または推測による削除ではなく根拠に基づいた削除候補リストを作成したいときに、このスキルを使用します。

Safety contract

• スキルを自動的に削除しない。 まず優先度付きの推奨リストを作成し、ユーザーが明示的に削除候補リストを承認した後にのみ削除を実行します。
• トリガーカウントを 最善努力のシグナル として扱い、絶対的な事実とは考えないこと。異なるエージェントはトランスクリプトを異なる方法で保存し、ログをローテーションしたり省略したりする可能性があります。
• ユーザーが「保持」と指定したスキルは、トリガーカウントがゼロでも保護してください。
• 同じ変更で README/docs/install の参照をチェックした後でのみ、ルートレベルのスキルディレクトリ全体を削除することを優先します。

インタビューを最初に実施

スキャンまたは削除推奨を行う前に、簡潔なインタビューを実施してください：

1. 主に使用しているエージェントはどれですか？ (Claude Code、Codex、OpenCode、OpenClaw/ClawHub、Hermes Agent、その他)
2. 絶対に削除してはいけないスキルは何ですか？
3. 確実に使わないスキルは何ですか？
4. 最近の 30/90/180 日のうち、どの期間の使用痕跡を優先的に確認しますか？ helper 実行時に --days または --since で反映します。
5. 推奨のみ希望ですか、それとも承認後に実際の削除まで希望ですか？

エージェント別トリガーカウントソース

エージェント	確認場所	信頼性	備考
Claude Code	~/.claude/projects/**/*.jsonl、~/.claude/transcripts/**/*.jsonl	最善努力	スキルトリガーイベント、$skill-name 記載、SKILL.md 読み込みを確認します。
Codex	~/.codex/sessions/**/*.jsonl、~/.codex/log/**/*.log、.omx/logs/**/*.log	最善努力	ルーティングされたスキル名、明示的な $skill 呼び出し、スキルファイルの読み込みを確認します。
OpenCode	~/.local/share/opencode/**/*.jsonl、~/.config/opencode/**/*.jsonl	最善努力	ローカルスキーマが異なる場合は、ユーザーにエクスポートされたトランスクリプトまたは使用 JSON を要求します。
OpenClaw/ClawHub	~/.openclaw/**/*.jsonl、~/.clawhub/**/*.jsonl (存在する場合)	手動確認	安定した公開ローカルトリガーカウントスキーマは想定されません。利用可能な場合はエクスポートされた統計を優先します。
Hermes Agent	~/.hermes/**/*.jsonl、~/.config/hermes/**/*.jsonl (存在する場合)	手動確認	安定した公開ローカルトリガーカウントスキーマは想定されません。利用可能な場合はエクスポートされた統計を優先します。

ローカルヘルパー

インストール済みのスタンドアロンスキルから、k-skill-cleaner スキルディレクトリの決定論的ヘルパーを実行します。フルリポジトリチェックアウトでは、scripts/k_skill_cleaner.py の互換性ラッパーが同じオプションを受け入れます。

python3 scripts/k_skill_cleaner.py \
  --skills-root . \
  --scan-default-logs \
  --days 90 \
  --never-use blue-ribbon-nearby,lotto-results \
  --keep k-skill-setup,k-skill-cleaner

エージェントエクスポートまたは手動キュレーション済みカウントの場合、スキル名をトリガーカウントにマップする JSON オブジェクトを渡します：

python3 scripts/k_skill_cleaner.py --skills-root . --usage-json usage-counts.json --days 90

--days と --since はスキャン対象のログレコードのみをフィルタリングします。--usage-json の値はすでに集計済みのカウントであるため、ヘルパーに渡す前に同じ時間ウィンドウで JSON を準備/エクスポートしてください。

ヘルパーは以下を含む JSON を出力します：

• skill_count: 検出されたルートレベルスキル数。
• candidates: trigger_count と reasons を含む優先度付き remove または review 候補。
• agent_usage_sources: 上記のエージェント固有パスと注釈。
• time_window: 有効な --since/--days カットオフと mtime フォールバック注釈。
• usage_json: インポート済みカウントが統合されたかどうかと事前ウィンドウ注釈。
• scanned_logs: スキャン可能なログファイル数と最善努力エビデンスをもたらしたパス。
• safety: ファイルが削除されなかったことの注意喚起。

推奨ポリシー

• remove: ユーザーが明示的にスキルを使わないと指定した。ゼロ/低いトリガーエビデンスを支援コンテキストとして記載します。
• review: トリガーカウントがゼロまたは選択された低使用閾値以下ですが、ユーザーが明示的に削除を要求していない。
• keep: ユーザーで保護されたスキルとアクティブに使用中のスキル。

報告時は、このようにグループ化します：

1. 削除候補 — インタビューで使わないと指定、トリガーエビデンス付き。
2. 検討候補 — トリガーカウントがゼロ/低いのみ。
3. 保持候補 — 保護されているまたは最近使用中。
4. 統計限界 — 読み取り可能なログがなく手動エクスポートが必要なエージェント。

削除が承認された場合

1. スキルディレクトリを削除します。
2. README テーブル/リスト エントリと docs/features/<skill>.md リンクを削除します。
3. docs/install.md --skill <skill> エントリを削除します。
4. スキルがそのファイルを所有している場合のみパッケージ/ワークスペース/テストの参照を削除します。
5. npm run lint、npm run typecheck、npm run test を実行します（パッケージング/リリース変更の場合は npm run ci を実行）。