Agents Validator
The Agents validator checks Claude Code agent definitions for correctness, including names, descriptions, tools, and model configuration.
What It Checks
- Agent frontmatter schema compliance
- Required fields (name, description)
- Name/filename consistency
- Tool references
- Model configuration
- Skill references
- Hook configuration
- Body content length
Rules
This validator includes 12 rules. See the Agents rules category for the complete list.
| Rule | Severity | Description |
|---|---|---|
| agent-name | error | Invalid agent name format |
| agent-description | error | Missing or invalid description |
| agent-model | error | Invalid model configuration |
| agent-name-filename-mismatch | error | Name does not match filename |
| agent-skills-not-found | error | Referenced skill not found |
| agent-body-too-short | warn | Agent body content below minimum length |
CLI Usage
bash
# Validate all agents
claudelint validate-agents
# Verbose output
claudelint validate-agents --verboseSee Also
- Claude Code Sub-agents - Official sub-agents documentation
- Configuration - Customize rule severity