Skills Janitor
Free MIT-licensed CLI that swipes away dead Claude Code and Codex skills and MCP servers to reclaim your context window.
Skills Janitor does one job most Claude Code power users keep procrastinating on: deleting the skills and MCP servers quietly renting space in every single request. The swipe deck turns a tedious audit into a five-minute habit, and the v1.7 MCP triage catches connected-but-never-called servers that most people never think to look for. The v1.6 security scan is calibrated — on a real 178-skill machine it flags 2, both genuinely worth reading — which makes it more useful than a scanner that cries wolf on everything. It is terminal-only and strictly Claude Code and Codex, so it is useless if you live in Cursor or a GUI. If you do live in that terminal, it is the most honest cleanup tool in the
Verified 7d ago · liveness 71/100 · cite: rightaichoice.com/tools/skills-janitor
- Claude Code power users with skills piled up across user, project, codex, and plugin scopes
- Developers running MCP servers who want to kill silent context waste from never-called tool schemas
- Token-conscious freelancers who want to cut API costs without manually tracing every skill
- Teams practicing prompt and context hygiene who need a repeatable, provable audit
- GUI-only users who avoid the terminal — every command here is a slash command, a TUI, or a shell script
- Projects on GitHub Copilot, Cursor, or other assistants — this targets Claude Code and Codex
- Anyone wanting a cloud dashboard or web UI to manage skills centrally
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip Skills Janitor if you work in Cursor or GitHub Copilot, need a web dashboard for team-wide skill governance, or expect per-MCP-server dollar estimates rather than provable call counts and last-used dates.
Skills Janitor is free and MIT-licensed, so there is no pricing tier to size against your headcount. Its real cost is the time you spend on the swipe deck and reading REVIEW/RISK verdicts. Compared with paid context-management or MCP governance products, it costs nothing but requires terminal comfort; the tradeoff is that you get no cloud dashboard or centralized team reporting in return.
In short
Skills Janitor — Free MIT-licensed CLI that swipes away dead Claude Code and Codex skills and MCP servers to reclaim your context window. Best for Claude Code power users with skills piled up across user, project, codex, and plugin scopes, Developers running MCP servers who want to kill silent context waste from never-called tool schemas, Token-conscious freelancers who want to cut API costs without manually tracing every skill. Free to use.
What's new in Skills Janitor
Checked 7 days agoAcross the latest 3 updates: 3 feature updates.
v1.7: MCP servers join the triage
Every configured MCP server is now inventoried and cross-referenced against real usage from session transcripts, with connected-but-never-called servers ranking high in the swipe deck. Swiping one left removes its config entry with a timestamped .bak.
v1.6: prompt-injection heuristic scan
Adds /janitor-security, which scans installed skills for instruction-override phrases, hidden instructions in HTML comments or zero-width unicode, base64 payloads, and scripts that pipe the network into a shell or read credential stores.
v1.4: interactive swipe TUI
Introduces /janitor-swipe, a Tinder-style deck sorted heaviest-and-least-used first. Arrow keys delete, keep, skip, undo, and inspect, and deletions are staged until confirmed.
What people actually say about Skills Janitor — is it worth it?
We ran a structured research pass across product reviews, community discussions, and post-purchase forum threads to surface the patterns vendors won't publish themselves. Below: the recurring strengths, the hidden costs people mention most, and the cohort that consistently regrets adopting this tool.
19 mentions across 3 sources (Product Hunt, GitHub, Lemmy) · researched Jul 3, 2026.
Average across the 3 sources that answered — each source counts once, not each post.
- +Interactive swipe interface makes cleanup fast and easy.
- +Scans user, project, codex, and plugin skill locations comprehensively.
- +Shows token cost per skill so you prioritize high-waste items.
- +Sorts heaviest and least-used skills first for maximum impact.
- +Zero external dependencies — fully offline and privacy-respecting.
- −Only supports Claude Code and OpenAI Codex — no other agents.
- −No overlap percentage for similar skills, just dedup detection.
- −Initial release missed /plugin install skills, requiring a fix.
- −Usage stats rely on local log parsing; proxy setups may break it.
- −Limited to skill management — doesn't optimize or write new skills.
Viability Score
How well maintained and how widely used is Skills Janitor? Built from what the vendor actually publishes (docs, changelog, tutorials, integrations, pricing), whether the site is live, and how much real users discuss it. How we calculate this
Last calculated: September 2026
How we score →Key Features
- Interactive Tinder-style swipe TUI for skills and MCP servers: left delete, right keep, down skip, u undo, i inspect
- Swipe deck sorted most-likely-waste first, so heaviest-and-least-used skills and never-called MCP servers rank high
- MCP server triage (v1.7): inventories user, project, .mcp.json, and plugin-bundled servers
- Cross-references MCP servers against real usage from session transcripts (mcp__server__tool records)
- Swiping an MCP server left removes its config entry with a timestamped .bak backup
- Cross-scope duplicate detection using Jaccard similarity above a 30% threshold
- Token cost reporting splitting always-loaded descriptions from on-demand skill bodies
- Usage counts pulled from real session transcripts, including skills Claude auto-triggered
- Health check for inventory, duplicates, and broken skills via /janitor-report, with --brief for inventory only
- Auto-fix broken symlinks and empty directories with --prune via /janitor-fix
- Prompt injection heuristic scan (v1.6+): instruction-override, hidden instructions, zero-width unicode, base64 payloads
- Pre-install security and overlap scan via /janitor-discover before you install a skill
- Natural language queries: 'check my skills', 'which skills are wasting context?', 'find an n8n skill'
- Plugin skills and plugin-bundled MCP servers flagged for plugin review rather than individually deletable
- Works with Claude Code and OpenAI Codex; zero dependencies beyond Bash, Python 3, and curl; offline-capable with no telemetry
About Skills Janitor
Skills Janitor is a free, MIT-licensed command-line tool for developers running Claude Code and OpenAI Codex whose skill and MCP server collections have sprawled across user, project, codex, and plugin scopes. It inventories everything a skill lives in — user, project, codex, plugin installs, plus subagents and MCP servers — then surfaces what is quietly eating your context window: duplicate skills across scopes (flagged with Jaccard similarity above 30%), broken symlinks, unused skills, and MCP servers that load their full tool schemas on every request but never actually get called. Usage counts come from your real session transcripts, including skills Claude auto-triggered, so the numbers are measured rather than guessed. The headline interface, added in v1.4, is an interactive swipe TUI sorted heaviest-and-least-used first: left arrow deletes, right keeps, down skips, u undoes, i inspects — most people burn through the top 5-10 cards and stop there, and deletion is staged until you confirm. As of v1.7 MCP servers join the deck, ranking high when they have been connected-but-silent across the last eight weeks of session transcripts; swiping one left removes its config entry with a timestamped .bak backup. Six slash commands cover the maintenance loop: /janitor-report (health check, --brief for inventory only), /janitor-fix (--prune removes broken symlinks and empty dirs), /janitor-value (token costs split into always-loaded descriptions versus on-demand bodies, for skills and subagents), /janitor-security (a v1.6+ heuristic prompt-injection scan that checks instruction-override phrasing, "don't tell the user" directives, instructions hidden in HTML comments or zero-width unicode, smuggled base64 payloads, and scripts that pipe the network into a shell or read credential stores), /janitor-discover (search GitHub for skills or pre-check a URL before installing, now with a security scan), and /janitor-swipe. You can also type plain English like "check my skills" or "which skills are wasting context?" to trigger the right command. It runs on Bash, Python 3, and curl with no other dependencies, works offline, sends no telemetry, and installs via /plugin marketplace add khendzel/skills-janitor, npx skills add khendzel/skills-janitor, or a direct git clone. The audience is narrow on purpose: Claude Code and Codex users comfortable in a terminal who want a repeatable, provable context-hygiene audit. There is no GUI and no cloud dashboard, plugin-bundled skills are flagged for plugin review rather than individually deletable, and MCP output reports provable call counts and last-used dates rather than per-server dollar estimates.
Behind the Verdict
The problem Skills Janitor addresses is real and easy to underestimate: every installed skill's description loads into context on every request whether or not you use it, and every configured MCP server loads its full tool schema the same way. A collection built up over a year of "this looks useful" installs can quietly tax every prompt you send. Most people know this in the abstract and never do anything about it, which is exactly the gap this tool targets. What it gets right: the data is measured, not guessed. Usage counts are pulled from real session transcripts and include skills Claude triggered on its own, so a skill you never manually invoked but which auto-fires twice a day does not get flagged as dead. Cross-scope duplicate detection uses Jaccard similarity above a 30% threshold, which catches the common pattern of the same skill existing in both your user scope and a project scope. The v1.7 MCP work is the sharpest part — cross-referencing configured servers against mcp__server__tool records in transcripts turns an invisible cost into a number you can act on, and the eight-week silence window for "connected but never called" is a sensible line. Deletion is staged with a timestamped .bak backup for anything it touches, which is the right amount of paranoia for a tool whose whole job is deleting files. The swipe TUI is the reason anyone will actually use it. Sorting the deck heaviest-and-least-used first means the highest-value deletion is card one, and most people hit their useful pruning in the first 5-10 cards. The honest limitation is that this becomes a self-limiting habit rather than a full audit — you are not going through 178 skills one at a time. The security scan (v1.6+) is a genuine differentiator because a skill is text your agent trusts unconditionally. Checking for instruction-override phrasing, "don't tell the user" directives, instructions buried in HTML comments or zero-width unicode, base64 payloads, and scripts that pipe the network into a shell or read credential stores covers the known bad shapes. The PASS/REVIEW/RISK verdicts are explicitly heuristics, and the tool says so — a RISK means read it before trusting it, not that it is malware. Being calibrated for low noise matters more than breadth here. Where it does not fit: it is Claude Code and Codex only. Cursor, GitHub Copilot, and other assistants get nothing. It is a terminal tool end to end — six slash commands and a TUI — with no web UI and no cloud dashboard for central team management, so a team that wants one shared pane of glass for skill governance will be disappointed. Plugin-installed skills and plugin-bundled MCP servers are flagged for plugin review rather than individually deletable, which is a sensible correctness decision but does mean you cannot fully prune from inside the janitor. And the MCP reporting deliberately stops at provable call counts and last-used dates — no per-server dollar estimates — so if you want a budget line item, you will
Researching Skills Janitor? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Real-world workflow fit
Concrete scenarios for the personas Skills Janitor actually fits — and what changes day-one when you adopt it.
Run /janitor-report to get an inventory of skills across user, project, codex, and plugin scopes, then /janitor-value to see which ones carry the heaviest always-loaded descriptions versus on-demand bodies. Switch to /janitor-swipe and clear the top of the deck, which is sorted heaviest-and-least-used first.
Outcome: The highest-token, least-used skills get deleted in a five-minute session, each with a timestamped .bak backup, and the context cost of every prompt drops.
Upgrade to v1.7 behavior and let the janitor inventory user, project, .mcp.json, and plugin-bundled MCP servers, then cross-reference each against mcp__server__tool records in the last eight weeks of session transcripts.
Outcome: Servers that were connected but silent rank high in the swipe deck; swiping left removes the config entry with a .bak, ending the per-request tool-schema overhead they were adding for nothing.
Run /janitor-discover against the skill URL before installing. The pre-install scan checks for instruction-override phrases, hidden instructions in HTML comments or zero-width unicode, base64 payloads, and scripts that pipe the network into a shell or read credential stores.
Outcome: You get a PASS / REVIEW / RISK verdict before the skill ever touches your agent, and any overlap with skills you already have is surfaced at the same time.
Use Cases
- Audit your Claude Code skill collection to find unused or duplicate entries across user, project, codex, and plugin scopes
- Reduce context window usage by deleting heavy, rarely-used skills that load on every request
- Scan installed skills for prompt injection, hidden instructions, or dangerous script patterns before trusting them
- Track which skills and subagents consume the most tokens per invocation versus sitting unused
- Pre-check a skill URL for security and overlap issues before installing it
- Fix broken skill symlinks and empty directories automatically with --prune
- Find MCP servers that have been connected but silent for eight weeks and remove their tool-schema overhead
Models Under the Hood
as of 2026-09-22
Limitations
- Skills Janitor only supports Claude Code and OpenAI Codex — Cursor, GitHub Copilot, and other assistants are out of scope.
- It is terminal-only: six slash commands plus a swipe TUI, with no GUI and no cloud dashboard for centralized team management.
- Swipe review is inherently partial — the deck is sorted so the top 5-10 cards carry most of the value, so it works as a habit rather than a complete audit of a large collection.
- Plugin-installed skills and plugin-bundled MCP servers are flagged for plugin review rather than individually deletable from inside the tool.
- MCP reporting shows provable call counts and last-used dates only — there are no per-MCP-server dollar estimates.
- Security verdicts are honest heuristics (PASS / REVIEW / RISK): a RISK means read this before trusting it, not that the skill is malware.
as of 2026-09-21
Verification history
We have re-verified Skills Janitor 7 times since . Each pass re-reads the vendor's own pages and re-checks every listed field against that evidence; passes where nothing had changed are marked as such.
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
Showing the 6 most recent of 7 verification passes.
Free to cite with attribution — this page re-verifies continuously.
12-month cost
Project the real annual outlay, including the implied monthly cost when only an annual tier is published.
Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.
Plans compared
For each published Skills Janitor tier: who it actually fits, and what it adds vs. the previous tier. Cross-reference the cost calculator above for projected annual outlay.
Free
$0
Ideal for
Any Claude Code or Codex user with a sprawling skill or MCP server collection who wants to prune context waste without paying for a context-management tool
What this tier adds
Starting tier — the whole tool is free and MIT-licensed. Includes all six slash commands, the swipe TUI, MCP triage, and the prompt-injection scan.
Where the pricing makes sense
The company stage and team size where Skills Janitor's pricing actually pencils out — and where peers do it cheaper.
Skills Janitor is free and MIT-licensed, so there is no pricing tier to size against your headcount. Its real cost is the time you spend on the swipe deck and reading REVIEW/RISK verdicts. Compared with paid context-management or MCP governance products, it costs nothing but requires terminal comfort; the tradeoff is that you get no cloud dashboard or centralized team reporting in return.
Setup time & first value
How long it actually takes to get something useful out of Skills Janitor — broken out by persona, not the marketing-page minute.
Fastest path is /plugin marketplace add khendzel/skills-janitor followed by /plugin install skills-janitor, which takes under a minute; npx skills add khendzel/skills-janitor and git clone into ~/.claude/skills/skills-janitor are the alternatives. Requirements are Bash, Python 3, and curl — no other dependencies. First useful output is a single /janitor-report run, typically minutes after install.
Switching to or from Skills Janitor
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From manual skill folder cleanup: run /janitor-report for the inventory and /janitor-swipe to triage, rather than deleting files by hand
- →From ad-hoc grep-and-rm scripts: replace with /janitor-fix --prune, which removes broken symlinks and empty directories and keeps a timestamped .bak
- →From a pre-install manual code read of every community skill: use /janitor-discover <url> for a security and overlap check first
- ↗To a cloud skill/MCP management dashboard: nothing to export — the tool edits local config files directly, so point the successor at the same scopes
- ↗To a non-Claude-Code assistant: there is no port path, since Skills Janitor only reads Claude Code and Codex skill scopes and MCP configs
- ↗To a fully manual workflow: keep the .bak backups the janitor leaves for deleted skills and MCP entries if you want to restore anything
Resources & Guides
Tutorials & Learning
YouTube returned 6 videos for “Skills Janitor”, and we withheld 6: 6 did not mention Skills Janitor. We are showing none, because we could not prove any of them are about Skills Janitor.
Official links
Tools that pair well with Skills Janitor
Common stack mates teams adopt alongside Skills Janitor, with the specific reason each pairing earns its keep.
Bito
Bito's Governor is an AI model router and code context engine that cuts coding agent spend by grounding every request in your codebase.
Continue
Open-source AI coding agent for VS Code and JetBrains — now free to fork after the Cursor acquisition.
Codeium
Devin Desktop (formerly Codeium) is a free AI coding assistant and multi-agent IDE with unlimited Tab completions and an Agent Command
Featured Head-to-Head Comparisons
Skills Janitor vs Spider Cloud
Choose Spider Cloud if you need a fast, scalable web scraping API for feeding real-time data into AI agents or RAG pipelines. Its Rust engine, AI extraction, and recent Browser AI commands give it a clear edge for high-volume data collection. Choose Skills Janitor if you use Claude Code and want to clean up skill bloat to reduce context costs — it’s free, offline, and purpose-built.
Skills Janitor vs Temporal Ai
If you need reliable, crash-proof orchestration for AI agents or microservices, Temporal is the clear choice — it’s trusted by OpenAI and offers the only durable execution platform with serverless workers. For Claude Code users drowning in skills that waste context and tokens, Skills Janitor is a free, instant fix that can cut skill token cost by 30–40% in one session. They solve entirely different problems; pick the one that matches your bottleneck.
Skills Janitor vs Voyage Ai
Choose Voyage AI if you're an enterprise building RAG pipelines with domain-specific retrieval needs (finance, legal) and have the budget. Choose Skills Janitor if you're a Claude Code user drowning in skills and want a free, interactive CLI tool to clean up context waste. They serve completely different purposes, so the decision is driven by your AI stack and budget.
Alternatives to Skills Janitor
View allFrequently Asked Questions
Categories
Best-of guides
Used Skills Janitor? Help shape our editorial sentiment research.