Agent skill
janitor-cleanup
Find and remove broken skills
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/janitor-cleanup
Metadata
Additional technical details for this skill
- version
- 1.0.0
SKILL.md
Prune
Find skills that need attention: broken symlinks, empty directories, and orphaned skills.
What It Finds
Broken Symlinks
Skills that point to deleted sources. These are dead weight - the skill folder exists but the target is gone.
Empty Directories
Skill folders with no SKILL.md file. Often leftover from incomplete installations or failed deletions.
Orphaned Skills
User-scope skills that duplicate a plugin skill. The plugin version is canonical and should be used instead.
How to Run
Run the scan script and filter for issues:
bash ~/.claude/skills/skills-janitor/scripts/scan.sh
Look for entries where is_symlink: true and symlink_target starts with "BROKEN:".
After Finding Issues
- Broken symlinks: safe to remove (target is gone)
- Empty directories: safe to remove
- Orphaned skills: suggest removing the user-scope copy and keeping the plugin version
- Always ask for confirmation before removing anything
Related Skills
- For full inventory:
/janitor-audit - For auto-fixing:
/janitor-fix - For error checks:
/janitor-check
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?