skill-validatorlisted
Install: claude install-skill Anvil-Code/skill-validator
# Skill Validator — Anvil & Code
Audits SKILL.md files for structural correctness, triggering strength, and marketplace readiness.
Produces a scored report with every issue categorized by severity and a specific fix for each.
---
## How to Use
Paste a SKILL.md file (or its contents) and say "validate this" or "audit this skill."
The validator will scan it, score it, and return a full report.
---
## Validation Checklist
Run every check below. Report every finding — do not silently skip checks that pass.
### YAML Frontmatter (Critical — failures here make the skill invisible)
| Check | Pass | Fail |
|-------|------|------|
| `name` field present | ✅ | ❌ CRITICAL: Skill won't load |
| `name` in kebab-case | ✅ | ⚠️ WARNING: May cause ID conflicts |
| `description` field present | ✅ | ❌ CRITICAL: Skill will never trigger |
| `description` is 60–120 words | ✅ | ⚠️ WARNING: Under 60 = under-triggers; Over 200 = diluted signal |
| `description` starts with an action verb | ✅ | ⚠️ WARNING: Passive descriptions under-trigger by ~40% |
| `description` contains 3+ trigger phrases | ✅ | ⚠️ WARNING: Skill won't fire on real user inputs |
| `description` names input AND output format | ✅ | ⚠️ WARNING: Claude can't match skill to context |
| No placeholder text in YAML | ✅ | ❌ CRITICAL: Placeholder text breaks triggering |
### Body Structure (Important — missing sections produce unreliable output)
| Check | Pass | Fail |
|-------|------|------|
| Has a clear purpose statement in f