Free Tool
CLAUDE.md Linter
Paste your CLAUDE.md and get instant feedback on size, content quality, security, and formatting. 20 rules backed by real data.
What we check
Size
- Line count (warn >200, error >500)
- Token estimate (warn >4K, error >8K)
Content
- Vague instructions (35% vs 89% compliance)
- Missing build/test commands
- Contradicting rules
- Hook candidates (ALWAYS/NEVER)
- Linter-eligible formatting rules
- Redundant conventions Claude already knows
- Instruction density (>100 = approaching ceiling)
- File descriptions (Anthropic says avoid)
- Inline API docs (>30 line code blocks)
Security
- API keys and tokens
- Passwords and secrets
- Private key blocks
Formatting
- Missing headings (>20 lines)
- Heading hierarchy violations
- Long prose blocks (>4 lines)
- Volatile content (versions, dates)
- Missing emphasis on critical rules
Rules sourced from Anthropic docs, HumanLayer research, community best practices, and our own experiments.