validate-skillslisted
Install: claude install-skill ivuorinen/skills
# Validate Skills
## Steps
1. Run the validator across all skills — public and internal:
```bash
uv run scripts/validate-skill.py
uv run scripts/validate-skill.py .claude/skills/*/SKILL.md
```
To validate only public skills:
```bash
uv run scripts/validate-skill.py
```
To validate only internal skills:
```bash
uv run scripts/validate-skill.py .claude/skills/*/SKILL.md
```
2. If any **errors** are reported, fix them before proceeding. Errors are blocking.
3. **Warnings** should be reviewed; fix if the skill is being released.
4. Run the version sync check:
```bash
uv run scripts/check-version-sync.py
```
5. If all checks pass, skills are release-ready.
## What is checked
| Check | Level |
|-------|-------|
| Frontmatter present | Error |
| `name` field present | Error |
| `description` field present | Error |
| Description contains "Use when" trigger clause | Error |
| Description ≤ 1024 chars | Error |
| Skill name matches directory name | Error |
| Header level progression (no skipping levels) | Error |
| Description with `': '` must be single-quoted | Error |
| Legacy output paths (`./codereview.md` etc.) | Warning |
| Body exceeds 500 lines | Warning |