Skip to content

Skills Validator

The Skills validator checks Claude Code skill definitions for correctness, security, documentation quality, and best practices.

What It Checks

  • SKILL.md frontmatter schema compliance
  • Required fields (name, description)
  • Version format validation
  • Shell script security (dangerous commands, eval usage)
  • Referenced file existence
  • Documentation quality (CHANGELOG, examples, README)
  • Naming conventions

Rules

This validator includes 43 rules. See the Skills rules category for the complete list.

CLI Usage

bash
# Validate all skills
claudelint validate-skills

# Validate with auto-fix
claudelint validate-skills --fix

# Verbose output
claudelint validate-skills --verbose

Plugin Skill

If you have the claudelint plugin installed, you can run this validator inside Claude Code with /validate-skills or by asking "Why is my skill not loading?"

See Also