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.

agent-name

Agent name does not follow naming conventions

Error

agent-name-filename-mismatch

Agent name in frontmatter does not match the filename

Error

agent-skills-not-found

Referenced skill does not exist in the project

Error

agent-body-too-short

Agent system prompt should have meaningful content

Warning

CLI Usage

# Validate all agents
claudelint validate-agents

# Verbose output
claudelint validate-agents --verbose

Agent files vs AGENTS.md

Claude Code agent files (.claude/agents/<name>.md) are single markdown files with YAML frontmatter that define sub-agents. Not to be confused with OpenAI's AGENTS.md, which provides project-wide instructions for Codex agents (similar to Claude Code's CLAUDE.md).

See Also

• Claude Code Sub-agents - Official sub-agents documentation
• Configuration - Customize rule severity