Rules Reference

Browse every validation rule by category. Each rule page includes severity, examples of correct and incorrect usage, and how to fix violations.

Featured Rules

claude-md-size

CLAUDE.md exceeds the maximum allowed size (40KB default)

WarningConfigurable

skill-dangerous-command

Skill contains potentially dangerous commands

Error

mcp-invalid-transport

Unknown or invalid MCP transport type

Error

agent-body-too-short

Agent system prompt should have meaningful content

Warning

plugin-invalid-marketplace-manifest

Marketplace manifest has structural errors

Error

skill-missing-shebang

Shell script missing shebang line

WarningFixable

Browse the sidebar for the complete list of rules organized by category, or see the Validators Overview for a summary of what each category checks.

Severity Levels

• error - Must be fixed. Causes non-zero exit code.
• warning - Should be fixed. Does not affect exit code.
• info - Informational suggestion.

Auto-fixable Rules

Some rules support automatic fixing:

claudelint check-all --fix

See Also

• Validators Overview - How validators work
• Configuration - Customize rule severity
• Custom Rules - Write your own rules
• CLI Reference - All CLI commands and flags