Paste your CLAUDE.md and get instant feedback. 12 rules check for placeholders, leaked secrets, structural issues, and best practices.
ClaudeCheck runs 12 rules against your CLAUDE.md to ensure Claude Code gets the best possible instructions.
file-not-empty error
File must not be empty
has-title error
Must have a top-level # heading
no-placeholders error
No [TODO], [Your X], [INSERT] leftovers
no-secrets error
No API keys, tokens, or passwords
min-length warn
Should be 200+ characters
has-sections warn
Should have multiple ## sections
heading-hierarchy warn
No skipped heading levels (h1→h3)
no-empty-sections warn
Sections must have content
has-actionable-content info
Should contain rules or guidelines
max-length info
Warns if over 50K characters
consistent-list-style info
Don't mix - and * list markers
no-bare-urls info
Use [text](url) markdown links
CLAUDE.md is a configuration file for Claude Code, Anthropic's AI coding assistant. It tells Claude about your project's conventions, tech stack, coding style, and rules. A well-written CLAUDE.md dramatically improves the quality of AI-generated code.
ClaudeCheck helps you write better CLAUDE.md files by catching common mistakes: leftover placeholder text from templates, accidentally committed secrets, poor structure, and missing best practices.
Also available as a CLI tool (npx claudecheck) and GitHub Action.
New here? Read the complete CLAUDE.md guide or browse ready-to-use examples.