validate-skills

Installation
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 command within a skills repository workflow
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)

Related skills

More from callstackincubator/agent-skills

Installs
2.8K
GitHub Stars
1.3K
First Seen
Jan 29, 2026