Cursor Rules Starter (Free)

Five Cursor rules in the right .mdc format, and a linter that tells you exactly how each rule will load and why one isn't.

Cursor Rules Starter (Free) cover

What it is

Five Cursor project rules you can drop into any repo today, plus lint_rules.py, a linter that tells you why a Cursor rule isn't loading.

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 4 tests OK on Python 3.13 and 3.10.

Real terminal output from Cursor Rules Starter: demo and passing tests

The rules (in .cursor/rules/)

RuleLoadsWhat it does
core-agent-workflow.mdcalways (13 lines)Read before editing, smallest change, match existing patterns, run checks, no invented packages, summary at the end.
core-git-commits.mdcAgent picks it for commits/PRsCommit subjects, Conventional Commits when the repo uses them, PR template, never force-push shared branches.
core-testing.mdcAgent picks it for test workMirror existing tests, regression test per bug fix, edge cases, deterministic tests, never weaken a failing test.
core-security.mdcAgent picks it for sensitive codeInput validation, parameterized SQL, no shell injection, authZ on every request, secrets out of code and logs.
core-code-review.mdcwhen you type @core-code-reviewA review checklist in severity order with file:line - problem - fix output.

Install

Copy the .cursor/rules/ folder into your project root (keep the .mdc extension; Cursor ignores plain .md files there). Open Customize -> Rules in Cursor to see them.

Lint your rules

python3 tools/lint_rules.py                         # lints ./.cursor/rules
python3 tools/lint_rules.py .cursor/rules --project .   # also checks globs and @file references against your code
python3 tools/lint_rules.py examples/broken-rules   # see what it catches

It checks the format Cursor documents (cursor.com/docs/rules): frontmatter with description, globs, alwaysApply; how each rule loads (always / by file / Agent picks / @-mention); plain .md files that are ignored; alwaysApply: yes; misspelled keys; globs ignored under alwaysApply: true; ./ or absolute globs; globs that match no file; missing @file references; empty, duplicate or 500+ line rules; vague instructions. Exit 1 on errors, --json for CI. Python 3.9+, no dependencies, offline. ./run_tests.sh runs the tests.

Honest limits

  • Rules guide the model; they don’t enforce anything.
  • The linter checks the format Cursor documents; it can’t tell whether a rule’s advice is right for your code.

Format and license

Zip, 12 KB, v1.0, 14 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with or endorsed by Cursor (Anysphere).

FAQ

Is it free?
Yes, free download, use it anywhere.
Why .mdc and not .md?
Cursor only reads .mdc files with frontmatter in .cursor/rules; plain .md there is ignored.
Does the linter need Cursor?
No, it's a Python script that runs anywhere.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Cursor Rules Starter (Free)

Free Cursor rules examples in .mdc format: agent workflow, commits, testing, security, code review. Includes a linter that shows why a rule isn't applying.

Pairs well with

DownloadFree

CLAUDE.md Linter (Free)

Free CLAUDE.md linter: broken @imports, files over 200 lines, .claude/rules paths that match nothing, AGENTS.md conflicts, dead npm scripts, leaked keys. Offline, CI-ready.

View CLAUDE.md Linter (Free)
DownloadFree

MCP Config Validator (Free)

Free MCP config validator and converter: check .mcp.json, .cursor/mcp.json, .vscode/mcp.json and claude_desktop_config.json for the mistakes that make servers silently fail.

View MCP Config Validator (Free)
Download$12

Cursor Rules for Next.js

11 Cursor rules for Next.js (Server/Client Components and more), written against current docs. Installs in one command, exports AGENTS.md. $12 once.

View Cursor Rules for Next.js

Related