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 ​