Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →legendtkl/agent-cleaner-skills
Identify unused Claude Code skills, subagents, and MCP servers and disable them to reduce system-prompt context bloat.
Passed 15 of 20 test cases with the skill, and 6 of 20 without it.
and 9 more in the full report
10 fixed7 passed either way6 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
I accidentally disabled a skill named user:codex:lark-mail and I need to restore it. What is the exact cleaner command syntax to re-enable this skill?
| Checked | Without skill | With skill |
|---|---|---|
| runs skills enable with the skill identifier | Missed | Passed |
The instructions your model reads when the skill loads.
When the user wants to slim Codex skills or MCP servers, follow the same
flow: enumerate → suggest → confirm → disable. The CLI exposes parallel
skills and mcp command trees on Codex (subagents are Claude Code-only).
Prefer ${AGENT_CLEANER_CLI} if set. Otherwise locate the newest installed bundle:
find "${CODEX_HOME:-$HOME/.codex}/plugins/cache/local/agent-cleaner" -path '*/lib/agent-cleaner.mjs' -type f 2>/dev/null | sort | tail -1
If that finds nothing, check the current repository path:
test -f plugins/codex/lib/agent-cleaner.mjs && pwd
Always invoke via node <abs-path> and always pass --host=codex.
node "<abs-path>/agent-cleaner.mjs" --host=codex skills suggest --json
The output is a JSON array of suggestions, each with id, name, source, reason (never-used | stale), confidence (high | medium | low), details.
If the user wants to see all skills, use skills list --json.
Show the suggestion list as a compact table with id, reason, and confidence. Never disable without explicit user confirmation.
If the user wants to adjust the staleness threshold, mention --unused-for=60d (or 2w, 3m, 1y) or persist a default in ~/.agent-cleaner/config.json:
{ "unusedForDays": 60 }
test cases passed, vs 6 / 20 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.