Cursor rules
Project, user, and team rules that the Cursor SDK and Agent load — `.cursor/rules/*.mdc`, `AGENTS.md`, and the legacy `.cursorrules`. Use when authoring rules that the SDK will pick up via `local.settingSources`, or when writing rule frontmatter with the right type (always / auto-attached / agent-requested / manual).From its SKILL.md
npx -y skills add HKTITAN/cursor-sdk --skill cursor-rulesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.9 KB, 357 tokens by cl100k_base, as published. Nobody here has run it
cursor-rules
Rules are how you bake context into a project so every Agent run starts with the right instructions. The SDK reads them through local.settingSources — see [[../cursor-sdk/references/local-options]].
When to use
- Adding repo-level coding conventions an SDK agent should follow
- Writing per-folder
AGENTS.mdfor nested context - Migrating from
.cursorrulesto.cursor/rules/*.mdc - Choosing between always-on, auto-attached, agent-requested, and manual rules
File locations
- [[references/file-locations]] —
.cursor/rules/,AGENTS.md, legacy.cursorrules - [[references/scope-and-precedence]] — team / project / user, hierarchy
Authoring .mdc rules
- [[references/mdc-frontmatter]] —
description,globs,alwaysApply - [[references/rule-types]] — Always / Auto-attached / Agent-requested / Manual
- [[references/glob-patterns]] —
**/*.tsx, comma-separated lists
AGENTS.md
- [[references/agents-md]] — markdown-only, nested per directory
- [[references/agents-md-vs-rules]] — when to pick which
SDK integration
- [[references/sdk-integration]] —
settingSourcesand what loads where - [[references/limitations]] — Tab and Inline Edit don't read rules
Cross-links
- SDK setting sources → [[../cursor-sdk/references/local-options]]
- Hooks (sibling .cursor/ feature) → [[../cursor-hooks/SKILL]]
- Skills (sibling .cursor/ feature) → [[../cursor-skills-system/SKILL]]
What ships with it: 9 files
6.0 KB alongside SKILL.md
references/
- agents-md.md704 B
- agents-md-vs-rules.md614 B
- file-locations.md801 B
- glob-patterns.md597 B
- limitations.md476 B
- mdc-frontmatter.md712 B
- rule-types.md868 B
- scope-and-precedence.md616 B
- sdk-integration.md753 B