Skip to content

khendzel/skills-janitor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skills Janitor

Audit, track usage, and compare your Claude Code skills - 9 focused skills, zero dependencies.

Skills Janitor

A plugin for Claude Code that keeps your skills ecosystem clean, organized, and healthy. Each action is its own skill with dedicated autocomplete.

Skills

Command What it does
/janitor-audit Show all your installed skills
/janitor-duplicates Find duplicate skills that do the same thing
/janitor-check Check skills for errors and missing info
/janitor-fix Automatically fix skill problems (safe preview first)
/janitor-cleanup Find and remove broken skills
/janitor-report Full health check of all your skills in one report
/janitor-usage Show which skills you use and which you never use
/janitor-search Search GitHub for new skills to install
/janitor-compare Compare your skill with similar ones on GitHub

Install

Plugin install (recommended):

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

Or clone directly:

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

Usage examples

Each skill has its own slash command with autocomplete:

/janitor-audit          → full skill inventory
/janitor-usage          → which skills you actually invoke
/janitor-search         → find skills on GitHub
/janitor-compare        → market analysis vs alternatives
/janitor-check          → check for errors
/janitor-fix            → auto-fix (dry-run by default)

Or use natural language - skills trigger from keywords in their descriptions:

"audit my skills"
"which skills do I use?"
"search for n8n skills"
"compare my-skill against alternatives"

Usage tracking

Parses your conversation history to show which skills you invoke and which you never use:

=== Skills Janitor - Usage Report ===
Period: 2026-02-24 to 2026-03-23 (4 weeks)

Active skills: 4 / 36 (11%)
Unused skills: 32 (89%)
Most used: n8n-workflows (17 total)
Recommendation: Remove 32 unused skills

Skill discovery

Search GitHub for Claude Code skills by keyword:

=== Skills Janitor - Skill Discovery ===
Search: "marketing"

  #  Repository                    Stars  Status
  1  coreyhaines31/marketingskills  1,234  INSTALLED
  2  acme/marketing-automation        456  AVAILABLE

Set GITHUB_TOKEN env var for better results and higher rate limits.

What it won't do

  • Never deletes anything without explicit confirmation
  • Never modifies plugin/marketplace skills
  • Respects that some overlap is intentional
  • Dry-run by default for all destructive operations

Requirements

  • Bash, Python 3, curl
  • No pip installs, no node modules

Structure

skills-janitor/
├── .claude-plugin/
│   └── marketplace.json      # Plugin manifest (9 skills)
├── skills/
│   ├── janitor-audit/SKILL.md
│   ├── janitor-duplicates/SKILL.md
│   ├── janitor-check/SKILL.md
│   ├── janitor-fix/SKILL.md
│   ├── janitor-cleanup/SKILL.md
│   ├── janitor-report/SKILL.md
│   ├── janitor-usage/SKILL.md
│   ├── janitor-search/SKILL.md
│   └── janitor-compare/SKILL.md
├── scripts/                  # Shared bash+python scripts
├── demo.gif
├── LICENSE                   # MIT
└── README.md

Contributing

PRs welcome. Each skill is self-contained in skills/janitor-*/SKILL.md.

License

MIT

About

Audit, track usage, and compare your Claude Code skills. 9 actions, zero dependencies.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages