How do I install the Cursor Rules skill?

Run npx skillmds@latest add tomevault-io/cursor-rules in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cursor Rules safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cursor Rules?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cursor Rules free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cursor Rules?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cursor Rules by tomevault-io — Agent Skill

Name: Cursor Rules
Author: tomevault-io

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). Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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]]

Source: HKTITAN/cursor-sdk — distributed by TomeVault.

---name: cursor-rulesdescription: 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). Use when this capability is needed.---# cursor-rulesRules 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]]---> Source: [HKTITAN/cursor-sdk](https://github.com/HKTITAN/cursor-sdk) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions