Validate skills

My assortment of Claude Code skills

Install

npx -y skills add ivuorinen/skills --skill validate-skills

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

Copied from the file, not written here

Use when verifying all skills in the repository are well-formed before a release or after adding/editing a skill.

3.0 KB, 433 tokens by cl100k_base, as published. Nobody here has run it

Run the validator across all skills — public and internal:

uv run scripts/validate-skill.py
uv run scripts/validate-skill.py .claude/skills/*/SKILL.md

To validate only public skills:

uv run scripts/validate-skill.py

To validate only internal skills:

uv run scripts/validate-skill.py .claude/skills/*/SKILL.md

If any errors are reported, fix them before proceeding. Errors are blocking.
Warnings should be reviewed; fix if the skill is being released.
Run the version sync check:
```
uv run scripts/check-version-sync.py
```
If all checks pass, skills are release-ready.

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
Command tables (`## Commands`, `## Internal commands`) ↔ `commands/*.md` files 1:1 (skills with a `commands/` dir)	Error
Duplicate headers within a SKILL.md body	Error
Command file h1 is `# /<skill> <command> — …`	Error
Command file has `## When to use`	Error
Command file header level progression	Error
Legacy output paths (`./codereview.md` etc.)	Warning
Body exceeds 500 lines	Warning

Read from the repository

Just SKILL.md. No reference files, no scripts.