janitor-fix
Automatically fix skill problems (safe preview first). Also use with --prune to find and remove broken symlinks, empty directories, and orphaned skills.
git clone --depth 1 https://github.com/khendzel/skills-janitor /tmp/janitor-fix && cp -r /tmp/janitor-fix/skills/janitor-fix ~/.claude/skills/janitor-fixSKILL.md
# Auto-Fix Automatically fix common skill issues. Dry-run by default - shows what would change without modifying files. ## How to Run ```bash bash ~/.claude/skills/skills-janitor/scripts/fix.sh # preview fixes bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply # apply fixes bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune # find broken/orphaned skills bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune --apply # remove broken skills ``` ## What It Fixes - Adds missing frontmatter delimiters (`---`) - Fills empty `description` fields with a template - Adds missing `version` field (defaults to "1.0.0") - Generates template descriptions using the skill folder name ## Prune Mode (`--prune`) Finds and removes broken skills: - **Broken symlinks** - skill folder points to deleted source - **Empty directories** - skill folder with no SKILL.md - **Orphaned skills** - user-scope copies of plugin skills Dry-run by default. Pass `--apply` to actually remove them. ## Safety - **Dry-run by default** - must pass `--apply` to write changes - Skips plugin/marketplace skills (changes get overwritten on update) - Skips broken symlinks (unless `--prune` mode) - Logs ALL changes with timestamps to `data/changelog.log` - Always asks for confirmation before removing ## Related Skills - For finding issues: `/janitor-report` - For usage analytics: `/janitor-usage` - For token cost: `/janitor-tokens`
Show all your installed skills. Deprecated alias — use /janitor-report --brief.
Find new skills on GitHub or check a specific skill before installing. Use when the user wants to search for skills, evaluate a skill URL, check overlap with existing skills before installing, or compare a local skill against alternatives.
Check if a new skill overlaps with existing ones before installing. Deprecated alias — use /janitor-discover with a URL or path.
Full health check of all your skills in one report. Use when the user wants to check for errors, find duplicates, detect broken skills, or get a complete overview of skill health. Pass --brief for inventory only.
Search GitHub for new skills to install. Deprecated alias — use /janitor-discover (combines search + pre-install check).
Show how many context window tokens each skill consumes. Deprecated alias — use /janitor-value (which combines tokens with usage).
Show which skills you use. Deprecated alias — use /janitor-value (which now combines usage + token cost).
Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste. Use when the user asks 'are my skills worth it', 'what's my context budget', 'which skills are dead weight', or anything about skill value, token cost, or usage.