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.
skill-dangerous-commandSkill contains potentially dangerous shell commands
skill-missing-versionSKILL.md missing required version field in frontmatter
skill-nameSkill name does not follow naming conventions
skill-missing-shebangShell script missing shebang line
CLI Usage
bash
# Validate all skills
claudelint validate-skills
# Validate with auto-fix
claudelint validate-skills --fix
# Verbose output
claudelint validate-skills --verbosePlugin 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
- Claude Code Skills - Official skills documentation
- Configuration - Customize rule severity