Communityコーディング&開発github.com

steipete/skill-cleaner

Codex/OpenClaw スキル監査ツール:予算・使用状況・重複・説明文の最適化をリアルタイムに可視化します。

skill-cleaner とは?

このスキルは、Codex や OpenClaw などの AI エージェントが持つスキル一覧を監査し、プロンプト予算の削減、重複スキルの発見、無効化候補の特定を支援します。特に、スキルの説明文を簡潔にすることでトークン消費を抑え、エージェントの応答品質を維持しながらコストを最適化するために役立ちます。 対応プラットフォームは Codex と OpenClaw を主対象とし、CLI から Node.js スクリプトを実行して使用します。指定した期間内のログを解析し、各スキルの使用頻度やプロンプト内での占有トークン量を算出。2% の予算制限を超えているスキルや、重複する名前・説明文を持つスキルをリストアップします。 また、Codex の内部レンダリングロジックを模倣し、frontmatter の解析やコンテキストウィンドウからの予算計算を行うため、実際のモデル可視状態に近いレポートを生成できます。重複判定では、スキル本体が類似している場合に削除候補を提案し、優先順位(Codex システムスキル>直接スキル>プラグイン>個人/リポジトリコピー)に従って保持すべきコピーを推奨します。 最終的には、ユーザーの確認後にのみ削除や編集を適用する安全な設計となっており、説明文の簡略化やスキルの無効化設定の変更をグループ化してコミットする方針です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Skill Cleaner

スキルのプロンプト予算を削減する、重複スキルを検出する、有効/無効なスキルルートを監査する、または削除すべきスキルやプラグインを判断するときにこれを使用してください。

ワークフロー

  1. このスキルディレクトリまたはリポジトリのルートからアナライザーを実行します:
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
  1. レポートを以下の順序で読んでください:
  • Skill Budget:Codex のライブインベントリ、2% の予算、予算内で使用されている分、および完全な説明によるプレッシャー。
  • Description candidates:説明が長いもの。文法を緩めるとプロンプト予算を節約できる可能性があります。
  • Duplicates:Codex、プラグインキャッシュ、リポジトリ内の兄弟スキル、個人のスキルルート間で同じスキル名またはほぼ同一の説明/本文を持つもの。
  • Unused candidates:最近の Codex/OpenClaw ログでユーザーによる言及や SKILL.md の読み取りが確認されなかったもの。
  • Root summary:スキルがどこから来たのか、設定で無効化されているかどうか。
  1. 削除または編集する前に:
  • 保持するコピーが存在し、読み込まれていることを確認してください。
  • 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 による言及、およびツール呼び出し引数で観測されたパス。

出力ポリシー

  • 最初は提案のみを行い、ユーザーが要求した場合のみ編集を適用します。
  • クリーンアップの適用を求められた場合は、説明文の修正、削除、設定の無効化など、小さなグループにまとめてコミットしてください。
  • 無視または追跡されていないスキルディレクトリを、移動先を明示せずに、またはそれらが破棄可能であることを確認せずに削除しないでください。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル