janitor-fix

Featured

Automatically fix skill problems (safe preview first). Also use with --prune to find and remove broken symlinks, empty directories, and orphaned skills. Trigger with '/janitor-fix'.

AI & Automation 117 stars 19 forks Updated 1 months ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
69
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Auto-Fix Automatically fix common skill issues. Dry-run by default — shows what would change without modifying files. ## Overview Repairs frontmatter problems (missing delimiters, empty descriptions, missing version fields) across user, project, and codex-scope skills, and — in `--prune` mode — removes broken symlinks and empty skill directories. Plugin/marketplace skills are never modified (changes would be overwritten on update). ## Prerequisites - Claude Code with the skills-janitor plugin installed (provides `scripts/fix.sh`) - bash 3.2+ (the stock macOS bash works; no external dependencies) - Write access to the user's own skill directories (`~/.claude/skills`, `./.claude/skills`, `~/.agents/skills`) ## Instructions ### Step 1: Preview first (always) ```bash bash ~/.claude/skills/skills-janitor/scripts/fix.sh # preview fixes bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune # preview broken/orphaned removals ``` ### Step 2: Show the user the preview and confirm Never jump straight to `--apply`. Present the `[DRY RUN]` lines and ask before writing. ### Step 3: Apply ```bash bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply # apply fixes 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 templat...

Details

Author
khendzel
Repository
khendzel/skills-janitor
Created
5 months ago
Last Updated
1 months ago
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category