Agent skill
janitor-fix
Automatically fix skill problems (safe preview first)
Install this agent skill to your Project
npx add-skill https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix
Metadata
Additional technical details for this skill
- version
- 1.0.0
SKILL.md
Auto-Fix
Automatically fix common skill issues. Dry-run by default - shows what would change without modifying files.
How to Run
bash ~/.claude/skills/skills-janitor/scripts/fix.sh # preview changes
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply # apply changes
What It Fixes
- Adds missing frontmatter delimiters (
---) - Fills empty
descriptionfields with a template - Adds missing
versionfield (defaults to "1.0.0") - Generates template descriptions using the skill folder name
Safety
- Dry-run by default - must pass
--applyto write changes - Skips plugin/marketplace skills (changes get overwritten on update)
- Skips broken symlinks
- Logs ALL changes with timestamps to
data/changelog.log - Never deletes anything
Important
- NEVER modify skill content without showing the diff first
- NEVER delete skills without explicit user confirmation
- Always run lint first to understand what needs fixing
Related Skills
- For finding issues:
/janitor-check - For duplicate detection:
/janitor-duplicates - For broken links/orphans:
/janitor-cleanup
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
janitor-check
Check skills for errors and missing info
janitor-audit
Show all your installed skills
janitor-duplicates
Find duplicate skills that do the same thing
janitor-compare
Compare your skill with similar ones on GitHub
janitor-report
Full health check of all your skills in one report
janitor-cleanup
Find and remove broken skills
Didn't find tool you were looking for?