Skills Janitor

Skills Janitor

Free MIT-licensed CLI that swipes away dead Claude Code and Codex skills and MCP servers to reclaim your context window.

71/100Safe BetFreeFree

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

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
  • Teams practicing prompt and context hygiene who need a repeatable, provable audit
Not ideal for
  • 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
Visit Website

IntermediateFastest 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.CLINo public APIVerified 7d ago
Pricing
Free
FreeFree tier
Learning curve
Intermediate
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.
Runs on
CLI
No public API
Who it's for
Claude Code power user with a year of accumulated skillsDeveloper running several MCP serversSecurity-conscious developer about to install a community skill from GitHub
Live sentiment
Is Skills Janitor actually worth it?

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
Run a free scan

3 free scans · no card needed

Skip it if

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.

The 30-second take
Price reality

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 ago

Across the latest 3 updates: 3 feature updates.

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.

76% positive24% critical

Average across the 3 sources that answered — each source counts once, not each post.

Recurring strengths
  • +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.
Recurring frustrations
  • −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.
Patterns worth knowing
Skill bloat is a real, widespread problem for Claude Code users; Skills Janitor fills a clear gap.
Seen on Product Hunt, GitHub
The swipe interface (janitor-swipe) is the standout feature, making cleanup feel gamified and fast.
Seen on Product Hunt, GitHub
Users want more granular dedup info, especially overlap percentage between similar skills.
Seen on Product Hunt
Learning curve
beginnerProductive in ~5 minutes

Viability Score

71/100
Safe Bet

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

Recent activity
90
Traction
100
Site health
95
User sentiment
76
What the vendor publishes
20

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

FreeIntermediateNo APICLI

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.

Claude Code power user with a year of accumulated skills

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.

Developer running several MCP servers

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.

Security-conscious developer about to install a community skill from GitHub

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

Claude CodeCodex

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.

  1. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  2. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  3. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  4. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  5. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  6. — 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.

Annual total
Free
Over 12 months
Effective monthly
—
—

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.

Migrating in
  • →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
Migrating out
  • ↗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.

Tools that pair well with Skills Janitor

Common stack mates teams adopt alongside Skills Janitor, with the specific reason each pairing earns its keep.

Featured Head-to-Head Comparisons

Alternatives to Skills Janitor

View all
Bito

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.

FreemiumTry
Continue

Continue

Open-source AI coding agent for VS Code and JetBrains — now free to fork after the Cursor acquisition.

FreeTry
Codeium

Codeium

Devin Desktop (formerly Codeium) is a free AI coding assistant and multi-agent IDE with unlimited Tab completions and an Agent Command

FreemiumTry

Frequently Asked Questions

Used Skills Janitor? Help shape our editorial sentiment research.