validate-skills

✓Verified·Scanned 2/18/2026

Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command.

by callstackincubator·v590b981·1.8 KB·427 installs
Scanned from main at 590b981 · Transparency log ↗
$ vett add callstackincubator/agent-skills/validate-skills

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)

CheckRule
name format1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens
name matches directoryDirectory name must equal name field
description length1-1024 characters, non-empty
Optional fields validlicense, metadata, compatibility if present

Best Practices (Claude Code)

CheckRule
Description formatThird person, describes what + when to use
Body lengthUnder 500 lines
References one-level deepNo nested reference chains
Links are markdownUse [text](path) not bare filenames
No redundancyDon't repeat description in body
ConciseOnly add context Claude doesn't already have

How to Run

  1. Find all skill directories:

    fd -t d -d 1 . skills/

  2. For each skill, read SKILL.md and check against the rules above

  3. 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