| name | validate-skills |
| description | Check this repo's skill invariants (name==folder==kebab-case, unique leaf names, every skill in its area README) and fix violations. |
| disable-model-invocation | true |
Validate this repo's skills
The fast gate that proves skill changes are sound before install.sh would catch them.
Steps
- Run the validator:
./scripts/validate-skills.sh
- Errors (exit non-zero) must be fixed — they will break
install.sh:
name != folder → make the name: frontmatter match the leaf folder name exactly.
not kebab-case → rename to lowercase words joined by single hyphens.
duplicate leaf name → rename one; leaf names are unique across the whole repo.
no 'name:' → add the frontmatter name: line.
- Warnings flag a skill with no entry in its area
README.md — add the one-line row
(unless the skill was just removed, in which case delete its stale row).
- Re-run until it reports
0 error(s). Treat that as the done-condition for skill changes.
Notes
- The check mirrors
install.sh's discovery (same domains, same pruned dirs), so passing here
means ./install.sh --dry-run will link cleanly.