Auto-Fix

How to Run

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

)

• Broken symlinks - skill folder points to deleted source
• Empty directories - skill folder with no SKILL.md
• Orphaned skills - user-scope copies of plugin skills

--apply

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