Skip to main content

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).

Source facts

Repository
HKTITAN/cursor-sdk
Last source activity
May 3, 2026 at 08:23
Detected SKILL.md language
English
Stars
2
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
10 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
cursor-rules
description
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).
metadata
{"internal":false,"source":"https://cursor.com/docs/context/rules"}
# 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.md` for nested context - Migrating from `.cursorrules` to `.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]] — `settingSources` and 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]]
View on GitHub