> validate-skills

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

fetch
$curl "https://skillshub.wtf/callstackincubator/agent-skills/validate-skills?format=md"
SKILL.mdvalidate-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

┌ stats

installs/wk0
░░░░░░░░░░
github stars1.0K
██████████
first seenMar 17, 2026
└────────────

┌ repo

callstackincubator/agent-skills
by callstackincubator
└────────────

┌ tags

└────────────