Skill Cleaner
スキルのプロンプト予算を削減する、重複スキルを検出する、有効/無効なスキルルートを監査する、または削除すべきスキルやプラグインを判断するときにこれを使用してください。
ワークフロー
- このスキルディレクトリまたはリポジトリのルートからアナライザーを実行します:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3
便利なバリエーション:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-live --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 6 --max-log-mb 800 --deep-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --context-tokens 272000 --budget-percent 2 --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/Dropbox/boxd/skills --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/.agents/skills --root-only --no-logs
- レポートを以下の順序で読んでください:
Skill Budget:Codex のライブインベントリ、2% の予算、予算内で使用されている分、および完全な説明によるプレッシャー。Description candidates:説明が長いもの。文法を緩めるとプロンプト予算を節約できる可能性があります。Duplicates:Codex、プラグインキャッシュ、リポジトリ内の兄弟スキル、個人のスキルルート間で同じスキル名またはほぼ同一の説明/本文を持つもの。Unused candidates:最近の Codex/OpenClaw ログでユーザーによる言及やSKILL.mdの読み取りが確認されなかったもの。Root summary:スキルがどこから来たのか、設定で無効化されているかどうか。
- 削除または編集する前に:
- 保持するコピーが存在し、読み込まれていることを確認してください。
- Codex の組み込みスキルでカバーされている場合は、リポジトリローカルまたは
agent-scriptsの重複を優先的に削除してください。 - リポジトリポリシーやライブ運用をエンコードしている OpenClaw のメンテナスキルは、リポジトリローカルのものを保持してください。
- 説明文に含まれるトリガー名詞(製品、ツール、アクション、オブジェクト)は維持してください。
アナライザーの注意事項
- デフォルトでは、
codex debug prompt-inputがモデルから見えるスキルリスト、順序、名前、エイリアスパスを正確に提供します。--no-liveはより広範なファイルシステムフォールバックを強制します。 - 広範なファイルシステムスキャンは重複、無効、アーカイブキャッシュの診断のために残されていますが、読み込まれているインベントリとしては扱われません。
- このスクリプトは Codex のモデル可視行形式を模倣します:
- name: description (file: path)。 - Frontmatter ルールを Codex と同様に適用します:YAML frontmatter のみ、デフォルト名は親ディレクトリから取得、
nameとdescriptionは1行にサニタイズ。 - Codex
core-skills/src/render.rsに従います:context_windowの 2%、トークンコストはceil(utf8_bytes / 4)、次に完全な説明→均等な説明の切り詰め→省略された最小行。エイリアステーブルの行コストも含まれます。 ~/.codex/models_cache.jsonから GPT-5.5 のcontext_windowを読み取ります。フォールバックは 272,000 トークンと 2% です。- デフォルトでは通常の Codex/プラグイン/リポジトリのスキルルートのみをスキャンします。Dropbox アーカイブなどの追加フォルダは
--root <path>を指定した場合にのみ含まれます。 --root-onlyは少なくとも1つの--root <path>を必要とし、ライブの Codex インベントリをスキップして、指定されたルートのみをスキャンします。- ルートは realpath で重複排除されるため、シンボリックリンクされたルート(例:
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills)が誤った重複を作成することはありません。 - 重複名の場合、説明/本文の類似性を報告し、本文がほぼコピーである場合にのみ削除候補を提案します。保持優先順位のデフォルトは、Codex システムスキル、次に直接の Codex スキル、次にプラグインスキル、最後に個人/リポジトリのコピーの順です。
- デフォルトで
~/.codex/history.jsonlと最近の~/.codex/sessions/**/*.jsonlをスキャンします。アーカイブされたセッションや一般的な OpenClaw/Clawd ログフォルダについては--deep-logsを追加してください。 - 使用エビデンスはヒューリスティックです:ユーザーの
$skill/use skillによる言及、およびツール呼び出し引数で観測されたパス。
出力ポリシー
- 最初は提案のみを行い、ユーザーが要求した場合のみ編集を適用します。
- クリーンアップの適用を求められた場合は、説明文の修正、削除、設定の無効化など、小さなグループにまとめてコミットしてください。
- 無視または追跡されていないスキルディレクトリを、移動先を明示せずに、またはそれらが破棄可能であることを確認せずに削除しないでください。