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 45 rules. See the Skills rules category for the complete list.
| Rule | Severity | Description |
|---|---|---|
| skill-missing-version | warn | Missing version field |
| skill-name | error | Invalid skill name format |
| skill-description | error | Missing or invalid description |
| skill-dangerous-command | error | Dangerous shell command detected |
| skill-missing-shebang | error | Shell script lacks shebang |
CLI Usage
bash
# Validate all skills
claudelint validate-skills
# Validate with auto-fix
claudelint validate-skills --fix
# Verbose output
claudelint validate-skills --verboseSee Also
- Claude Code Plugin - Plugin skills reference
- Claude Code Skills - Official skills documentation
- Configuration - Customize rule severity