Skip to content

Skills Janitor

Tinder for your Claude Code skills, subagents and MCP servers. Swipe away what wastes context, scan for prompt injection, get honest token costs. Fixes what it finds and…

Install

$/plugin marketplace add khendzel/skills-janitor

Install command taken from the project's README or registry entry. Always review code before running it.

Skills Janitor

Tinder for your Claude Code skills. Swipe through your collection and delete what's wasting context, in seconds.

Works with Claude Code and OpenAI Codex. 6 commands, zero dependencies.

Status (v1.8, September 2026): maintenance mode. Claude Code now does the core of this natively.

When this project started, nothing in Claude Code told you which skills were eating your context. Now it does:

  • /skill-doctor shows what each skill costs in context and how often it gets used, and flags the ones never invoked
  • /doctor finds unused skills, MCP servers and plugins against their context cost, and fixes them after asking
  • /doctor prompt-audit audits your CLAUDE.md files, skills, agents and commands for outdated or conflicting instructions
  • /skills sorts by token count (t) and hides a skill with Space

If you only use Claude Code and only want to trim context, use those. They see real usage from inside the harness, which a plugin never can.

The janitor stays useful for what still isn't built in: security scanning (/janitor-security, plus a pre-install check in /janitor-discover), duplicate detection across skills, OpenAI Codex support, and actually deleting broken symlinks and dead skill folders. Bug fixes and PRs are still welcome. No new features are planned.

Thanks to everyone who installed it, filed issues and sent fixes: #4 of the day on Product Hunt, 120+ stars, and PRs from @nshonda, @lulzpid and @jerryhuangzq-lang. We were early, and now it's native. That's a good ending for a janitor.

Scans every place a skill lives: user, project, codex, and every skill installed via /plugin install — plus your subagents and MCP servers. Surfaces duplicates, broken symlinks, unused skills, and connected-but-never-called MCP servers cluttering your context. Usage counts come from real session transcripts, including skills Claude auto-triggered.

Commands

Command What it does
/janitor-report Health check: inventory, duplicates, broken skills. --brief for inventory only.
/janitor-fix Auto-fix issues. --prune removes broken symlinks and empty dirs.
/janitor-value Honest token costs (always-loaded descriptions vs on-demand bodies) + usage, skills and subagents.
/janitor-security Heuristic scan for prompt injection, hidden instructions, and dangerous script patterns. (v1.6+)
/janitor-discover Search GitHub for skills, or check a URL before installing — now including a pre-install security scan.
/janitor-swipe Interactive TUI — swipe keep/delete/skip through skills AND MCP servers, sorted most-likely-waste first. (v1.4+)

Each has its own slash command. Or use natural language: "check my skills", "which skills are wasting context?", "find an n8n skill".

Install

/plugin marketplace add khendzel/skills-janitor
/plugin install skills-janitor

Or via skills.sh:

npx skills add khendzel/skills-janitor

Or clone directly:

git clone https://github.com/khendzel/skills-janitor ~/.claude/skills/skills-janitor

Security scan (v1.6)

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…

Explore related