heal-skilllisted

# $heal-skill — Automated Skill Maintenance > **Purpose:** Detect and auto-fix common skill hygiene issues across the skills/ directory. **YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.** --- ## Quick Start ```bash $heal-skill # Check all skills (report only) $heal-skill --fix # Auto-repair all fixable issues $heal-skill --strict # Check all skills, exit 1 on findings (CI mode) $heal-skill skills/council # Check a specific skill $heal-skill --fix skills/vibe # Fix a specific skill ``` --- ## What It Detects Ten checks, run in order: | Code | Issue | Auto-fixable? | |------|-------|---------------| | `MISSING_NAME` | No `name:` field in SKILL.md frontmatter | Yes -- adds name from directory | | `MISSING_DESC` | No `description:` field in SKILL.md frontmatter | Yes -- adds placeholder | | `NAME_MISMATCH` | Frontmatter `name` differs from directory name | Yes -- updates to match directory | | `UNLINKED_REF` | File in references/ not linked in SKILL.md | Yes -- converts bare backtick refs to markdown links | | `EMPTY_DIR` | Skill directory exists but has no SKILL.md | Yes -- removes empty directory | | `DEAD_REF` | SKILL.md references a non-existent references/ file | No -- warn only | | `SCRIPT_REF_MISSING` | SKILL.md references a scripts/ file that does not exist | No -- warn only | | `INVALID_AO_CMD` | SKILL.md references an `ao` subcommand that does not exist (only runs if `ao` is on PATH) | No -- warn only | |