skill-health-checklisted

# Skill Health Check ## Trigger - Keywords: skill health, skill audit, skill lint, check skills, skill quality, validate skills ## When NOT to Use - Code review (use `/codex-review-fast`) - Document review (use `/codex-review-doc`) - Creating new skills (use `/create-skill`) - .claude directory structure check (use `/claude-health`) ## Core Principle Skills are **on-demand context packages**. Their value comes from routing precision (right skill triggers at right time) and context efficiency (minimum tokens for maximum capability). A poorly routed skill wastes context on every mismatch; a well-routed skill transforms a generalist into a specialist at exactly the right moment. ## Workflow ``` Run automated lint → Review manual dimensions → Produce integrated report → Gate ``` ### Step 1: Automated Lint ```bash bash scripts/run-skill.sh skill-health-check skill-lint.js --fix-hint ``` **Script I/O contract:** | Parameter | Description | |-----------|-------------| | `--skills-dir <path>` | Skills directory (default: `./skills`) | | `--commands-dir <path>` | Commands directory (default: `./commands`) | | `--json` | Output JSON instead of markdown | | `--fix-hint` | Include fix suggestions | | Exit 0 | All pass | | Exit 1 | Warnings only (P2) | | Exit 2 | Errors found (P0/P1) | **Automated checks (8 items):** | # | Check | Severity | Criteria | |---|-------|----------|----------| | 1 | Frontmatter exists | P0 | `name` + `description` required | | 2 | Routing signatur