I kept writing Cursor rules that the AI silently ignored. After digging into why, I found a pattern: contradicting directives across files, globs that don't match what you think, YAML frontmatter errors that cause Cursor to skip your rule entirely. So, I built a tool.

npx cursor-doctor scan gives you a health grade (A-F) in 2 seconds. npx cursor-doctor lint tells you exactly what's wrong, file by file. There are 100+ checks so far.

Most of the tool is free (scan, lint, init, migrate). I'd love feedback on what else you'd want checked.