validate-skills▌
callstackincubator/agent-skills · updated Apr 8, 2026
Validates skills against agentskills.io spec and Claude Code best practices.
- ›Checks skill metadata compliance including name format, description length, and optional fields like license and compatibility
- ›Enforces Claude Code best practices: third-person descriptions, body length limits, single-level references, and markdown link formatting
- ›Provides structured validation reports flagging spec violations and authoring guideline deviations
- ›Designed for use via /validate-skills comman
Validate Skills
Validate all skills in skills/ against the agentskills.io spec and Claude Code best practices.
Validation Checklist
For each skill directory, verify:
Spec Compliance (agentskills.io)
| Check | Rule |
|---|---|
name format |
1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens |
name matches directory |
Directory name must equal name field |
description length |
1-1024 characters, non-empty |
| Optional fields valid | license, metadata, compatibility if present |
Best Practices (Claude Code)
| Check | Rule |
|---|---|
| Description format | Third person, describes what + when to use |
| Body length | Under 500 lines |
| References one-level deep | No nested reference chains |
| Links are markdown | Use [text](path) not bare filenames |
| No redundancy | Don't repeat description in body |
| Concise | Only add context Claude doesn't already have |
How to Run
-
Find all skill directories:
fd -t d -d 1 . skills/ -
For each skill, read
SKILL.mdand check against the rules above -
Report issues in this format:
## Validation Results ### skills/example-skill - [PASS] name format valid - [FAIL] name "example" doesn't match directory "example-skill" - [PASS] description length OK (156 chars)
References
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★40 reviews- ★★★★★Ishan Desai· Dec 28, 2024
validate-skills has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Li Li· Dec 4, 2024
Useful defaults in validate-skills — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Benjamin Rao· Nov 23, 2024
validate-skills has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Daniel Singh· Nov 19, 2024
Useful defaults in validate-skills — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Amina Liu· Oct 14, 2024
Keeps context tight: validate-skills is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Amelia Diallo· Oct 10, 2024
validate-skills is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Isabella Agarwal· Sep 25, 2024
validate-skills has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Chinedu Iyer· Sep 21, 2024
We added validate-skills from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Yash Thakker· Sep 5, 2024
Useful defaults in validate-skills — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Dhruvi Jain· Aug 24, 2024
validate-skills is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
showing 1-10 of 40