validate-skills

callstackincubator/agent-skills · updated Apr 8, 2026

$npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills
0 commentsdiscussion
summary

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
skill.md

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

  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

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.740 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

1 / 4