# Cursor Rules vs Skills: Official Docs Explained

> What Cursor's own docs say about rules vs skills vs commands, explained in plain language: rules are always-on or glob-scoped constraints, skills are on-demand SKILL.md playbooks, commands are workflows you type with /.

Canonical: https://www.agentickit.co/compare/cursor-rules-vs-skills
Last updated: 2026-11-18

Per Cursor's own documentation, a rule (.cursor/rules/*.mdc) is a standing constraint that loads always or by glob, a skill (.cursor/skills/*/SKILL.md) is a playbook the agent opens on demand, and a command (.cursor/commands/*.md) only runs when you type it — see Cursor's docs on commands linked below for the source. Rules constrain, skills teach, commands are typed. Don't put the same text in two places. Last updated 2026-10-31 by Rakshit Yadav.



## Rules vs skills vs commands at a glance
<table><thead><tr><th></th><th>Rules</th><th>Skills</th><th>Commands</th></tr></thead><tbody><tr><td>**Loads**</td><td>Always, or when a glob matches</td><td>When the task matches the description, or when invoked</td><td>Only when you type it</td></tr><tr><td>**Triggered by**</td><td>Cursor</td><td>The agent or you</td><td>You</td></tr><tr><td>**Folder**</td><td>`.cursor/rules/`</td><td>`.cursor/skills/&lt;name&gt;/SKILL.md`</td><td>`.cursor/commands/*.md`</td></tr><tr><td>**Best for**</td><td>Short bans and conventions</td><td>Longer playbooks</td><td>Repeatable multi-step jobs</td></tr></tbody></table>Official reference: [Cursor docs: Commands](https://docs.cursor.com/en/agent/chat/commands); check the current Cursor docs for rules and skills, which are still changing. Cursor has also been moving slash-command-style workflows toward skills, with a `/migrate-to-skills` command in recent versions (verify it exists in your Cursor build). Commands and skills overlap most; see [Cursor Skills vs Commands](https://www.agentickit.co/compare/cursor-skills-vs-commands).
New to skills? Start with [Best Cursor Skills in 2026](https://www.agentickit.co/blog/best-cursor-skills).

## The one-line difference
**Rules** (`.cursor/rules/*.mdc`) are passive. They fire always, or when a glob matches. **Skills** (`.cursor/skills/*/SKILL.md`) are playbooks the agent loads when the task matches the description, or when a command points at them.
Cursor's own docs now steer extension toward skills so the window stays lean. Rules remain for hard prohibitions and path-scoped law.

## Use a rule when
- The instruction must apply to every turn (read CURSOR.md, tenant from session).
- The instruction should fire only on `app/api/**` or `*.sql`.
- It is a ban, not a manual: no `any`, no raw SQL in the route.

## Use a skill when
- The standard is longer than a screen: Stripe webhooks, RAG chunking, on-page SEO.
- You only want it loaded on matching work.
- An agent or command should open a named playbook.
Examples: [Stripe payments skill](https://www.agentickit.co/skills/stripe-payments), [on-page SEO skill](https://www.agentickit.co/skills/on-page-seo), [Next.js App Router skill](https://www.agentickit.co/skills/next-app-router).

## Do not duplicate
If a rule and a skill disagree, the rule wins and you have a mess. If they say the same thing, you paid twice in tokens. AgenticKit keeps a short always-on core and puts the manuals in skills. Grade a fat dump with the [Rules File Grader](https://www.agentickit.co/tools/rules-grader) before you migrate it.



## FAQ

### Are Cursor skills replacing rules?
No. Skills are preferred for on-demand playbooks. Rules still own always-on and glob-scoped constraints.

### Should I migrate all .mdc files to SKILL.md?
Only the long ones. Keep tenant-from-session and error-envelope rules as rules.

### What is the difference between a Cursor command and a skill?
A command is a markdown workflow you trigger by typing / and its filename. A skill is a SKILL.md playbook the agent can load on its own when the task matches its description.

### What does /migrate-to-skills do?
It is a Cursor command that has appeared in recent versions for converting older rules and commands into skills. Behavior may change, so read the current Cursor docs and review the generated SKILL.md files before committing them.

### Where do rules, skills and commands go?
Rules in .cursor/rules, skills in .cursor/skills/<name>/SKILL.md, commands in .cursor/commands.

## Related
- [What Is a Cursor Skill? Plain-English guide](https://www.agentickit.co/blog/what-is-a-cursor-skill)
- [Cursor Rules vs Skills: Which One Do You Need](https://www.agentickit.co/compare/cursor-rules-vs-skills-decision)
- [Cursor Skills vs Commands](https://www.agentickit.co/compare/cursor-skills-vs-commands)
- [Rules vs Skills vs Commands vs Hooks: The Only Diagram You Need](https://www.agentickit.co/blog/rules-vs-skills-vs-commands-vs-hooks)
- [Cursor Rules for Next.js App Router Projects](https://www.agentickit.co/compare/cursor-rules-nextjs-app-router)
- [Cursor Rules Examples: React Native, Go, Flutter, Svelte](https://www.agentickit.co/compare/cursor-rules-examples-react-native-go-flutter-svelte)
- [Cursor Skills pillar](https://www.agentickit.co/skills)
- [Project conventions skill](https://www.agentickit.co/skills/project-conventions)
- [Best Cursor skills: SKILL.md and 12 to install](https://www.agentickit.co/blog/best-cursor-skills)
- [Cursor rules for SaaS founders](https://www.agentickit.co/blog/cursor-rules-saas-founders)
- [Rules File Grader](https://www.agentickit.co/tools/rules-grader)
- [Cursor Skills vs MCP Servers](https://www.agentickit.co/compare/cursor-skills-vs-mcp)
- [Cursor Rules vs AGENTS.md vs CLAUDE.md](https://www.agentickit.co/compare/cursor-rules-vs-agents-md-vs-claude-md)
- [Cursor Commands vs Rules Files](https://www.agentickit.co/compare/cursor-commands-vs-rules)
