Skill auditing
Creates an inventory of skills and flags duplicates, broken symlinks, and other clutter across user, project, codex, and plugin-installed skills.
Skills Janitor
Skills Janitor is a GitHub-hosted set of slash commands for auditing, tracking, and cleaning up Claude Code and OpenAI Codex skills.
Overview
Skills Janitor is a GitHub repository that packages slash commands for auditing, tracking, and managing Claude Code and OpenAI Codex skills. Its documented purpose is to help users inspect where skills live, identify duplicates or broken symlinks, and clean up unused items that add noise to the working context.
The project is organized around self-contained skill folders and scripts, with installation paths for both Claude Code plugin workflows and direct cloning. The README also says it has zero dependencies, with Bash, Python 3, and curl as the stated runtime requirements.
Core capabilities
Repair and cleanup
Runs automatic cleanup actions, including pruning broken symlinks and empty directories when requested with the fix command.
Usage and value view
Surfaces token and usage waste in a combined view so you can sort skills by cost or clutter instead of manually checking each one.
Skill discovery
Lets you search GitHub for skills or validate a URL before installing, which fits the discover-then-install workflow.
Cross-tool compatibility
Supports both Claude Code and OpenAI Codex, with each command packaged as a self-contained `SKILL.md` plus a sibling script.
Backward-compatible command set
Tracks the v1.2 to v1.3 command renames and keeps the older commands available as deprecated aliases for a transition period.
Common use cases
Audit an existing skills setup
Run a health check to inventory skills, spot duplicates, and surface broken symlinks before they create confusion in your workspace.
Clean up stale or invalid skills
Use the fix workflow to prune broken links and empty directories after you have identified clutter that should be removed.
Review skill usage and waste
Compare token and usage waste across skills to decide which ones should stay active and which ones should be consolidated.
Discover and vet new skills
Search GitHub for a skill or verify a URL first when you want to install something new with less guesswork.
Adopt the newer command set
Migrate from older command names by following the documented v1.2 to v1.3 renames while keeping deprecated aliases working during the transition.
Pros and Cons
Pros
- Covers multiple skill scopes, including user, project, codex, and plugin-installed skills.
- Provides both reporting and repair workflows, so you can inspect issues before fixing them.
- Includes a discover command for finding skills on GitHub or checking a URL before install.
- Uses zero package-manager dependencies, which keeps setup lightweight.
- Documents deprecated aliases to reduce disruption during the v1.2 to v1.3 transition.
Cons
- The README does not provide a standalone web app or hosted service; it is a repository-based tool you install and run in your own environment.
- The command list and naming changed from v1.2 to v1.3, so existing users need to follow the migration notes.
FAQ
What does Skills Janitor do?
It is a set of slash commands for Claude Code and OpenAI Codex that audits skills, reports duplicates and broken links, helps fix issues, and can search for new skills before installation.
Which tools does it support?
The README says it works with Claude Code and OpenAI Codex, and the installation examples show both `/plugin marketplace add khendzel/skills-janitor` and cloning into a Claude skills directory.
How many commands does it include?
The current release notes in the README describe seven slash commands. The same page also notes that the five v1.2 commands continue as deprecated aliases until v1.4.
Does it require extra package installs?
No. The repository describes it as having zero dependencies and lists Bash, Python 3, and curl as requirements.
Is there a migration path from v1.2?
The README points to `CHANGELOG.md` for full release notes and says the v1.2-to-v1.3 command renames remain available as deprecated aliases until v1.4.
Quick Facts
- Category
- Developer Tool
- Source
- github.com/khendzel/skills-janitor
- Primary environments
- Claude Code and OpenAI Codex
- Installation
- Plugin marketplace add, direct clone, or install into a Claude skills directory
- Requirements
- Bash, Python 3, and curl
- Pricing
- Open-source GitHub repository; GitHub pricing page shows free and paid account plans, but this project itself does not list a product price
Skills Janitor Alternatives
Struere
Struere turns spreadsheet data into structured operational software with dashboards, alerts, and automations for teams replacing manual spreadsheet workflows.
Falconer
Falconer is an AI-powered company brain that keeps internal docs accurate, searchable, and up to date by syncing with GitHub, Slack, and Linear.
PromptScout
PromptScout tracks how ChatGPT, Gemini, Google AI Overviews, and Perplexity mention your brand or competitors, with source analysis and website audits.
Goldfish
Goldfish is an AI memory app for macOS that helps you reply, write, summarize, and continue with context already on your Mac. It stores memory locally and writes in your tone.
Lasso
Lasso is an ecommerce product data platform for enriching catalog records, processing supplier files, generating product content, and tracking competitors. It includes a web app, REST API, SDK, and MCP server.
SaveMRR
SaveMRR is a Stripe retention tool for SaaS teams to scan churn and MRR leaks, then automate recovery with dunning, cancel-save offers, win-back emails, and onboarding nudges.