cursor-rules-lint

Lint your Cursor rules for errors, conflicts, and bad patterns.

npx cursor-rules-lint

Scans every .mdc file in .cursor/rules/ and reports:

• Broken or missing YAML frontmatter
• Rules that will never load (alwaysApply: false with no globs)
• Vague instructions that don't change model behavior
• Contradicting rules across files (48 semantic conflict patterns)
• Invalid glob patterns (Windows backslashes, overly broad matches)
• Duplicate content wasting your token budget

No install, no config, zero dependencies in your project.

Commands

npx cursor-rules-lint          # detailed per-file lint report
npx cursor-rules-lint scan     # quick health grade (A-F)
npx cursor-rules-lint check    # CI-friendly (exits 1 on D/F grade)

How it works

This package wraps cursor-doctor, which runs 100+ checks on your Cursor rule files. All the actual linting logic lives in cursor-doctor.

Links

• Full documentation
• cursor-doctor on npm
• GitHub