---
description: Browse all claudelint validation rules organized by category. Covers severity levels, auto-fixable rules, and featured rules for CLAUDE.md, Skills, MCP, Agents, and Plugin.
---

# 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

<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 12px; margin: 16px 0;">

<RuleCard
  rule-id="claude-md-size"
  description="CLAUDE.md exceeds the maximum allowed size (40KB default)"
  severity="warning"
  category="CLAUDE.md"
  link="/rules/claude-md/claude-md-size"
  :configurable="true"
/>

<RuleCard
  rule-id="skill-dangerous-command"
  description="Skill contains potentially dangerous commands"
  severity="error"
  category="Skills"
  link="/rules/skills/skill-dangerous-command"
/>

<RuleCard
  rule-id="mcp-invalid-transport"
  description="Unknown or invalid MCP transport type"
  severity="error"
  category="MCP"
  link="/rules/mcp/mcp-invalid-transport"
/>

<RuleCard
  rule-id="agent-body-too-short"
  description="Agent system prompt should have meaningful content"
  severity="warning"
  category="Agents"
  link="/rules/agents/agent-body-too-short"
/>

<RuleCard
  rule-id="plugin-invalid-marketplace-manifest"
  description="Marketplace manifest has structural errors"
  severity="error"
  category="Plugin"
  link="/rules/plugin/plugin-invalid-marketplace-manifest"
/>

<RuleCard
  rule-id="skill-missing-shebang"
  description="Shell script missing shebang line"
  severity="warning"
  category="Skills"
  link="/rules/skills/skill-missing-shebang"
  :fixable="true"
/>

</div>

Browse the sidebar for the complete list of rules organized by category, or see the [Validators Overview](/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:

```bash
claudelint check-all --fix
```

## See Also

- [Validators Overview](/validators/overview) - How validators work
- [Configuration](/guide/configuration) - Customize rule severity
- [Custom Rules](/development/custom-rules) - Write your own rules
- [CLI Reference](/guide/cli-reference) - All CLI commands and flags
