Cursor Agent Skills
Cursor now supports Agent Skills in the editor and CLI. This guide explains what a Cursor skill is, how SKILL.md workflows differ from persistent Rules and external MCP tools, and how to start with a small setup a team can actually verify.
Fast answer
Cursor Agent Skills are reusable workflows and domain instructions defined in SKILL.md files. Cursor can discover a relevant skill during a task, and users can also invoke one from the slash command menu. Use Rules for persistent coding guidance and MCP when the agent needs access to an external tool or data source.
Use this page when
Decision matrix
| Goal | Open first | Reason |
|---|---|---|
| I need a reusable review, test, or release workflow. | Agent Skill (SKILL.md) | A skill packages a dynamic procedure the agent can load when the task calls for it. |
| I need coding standards to apply across normal conversations. | Cursor Rules | Rules provide persistent project or team guidance instead of a task-specific workflow. |
| I need Cursor to reach GitHub, a browser, a database, or tickets. | MCP connection | MCP exposes external tools and data; it is not a replacement for workflow instructions. |
| I need to choose between Cursor and adjacent coding agents. | Claude Code vs Codex vs Cursor | The comparison page covers environment and workflow fit rather than skill installation. |
Definition
Cursor describes Agent Skills as an open way to give the editor and CLI domain knowledge, procedures, scripts, and reusable commands. The agent loads a skill when it is relevant instead of keeping every instruction in context all the time.
Choose the right layer
A reliable Cursor setup separates reusable procedures, persistent guidance, and external access. Treating all three as “skills” makes invocation and permissions harder to understand.
Invocation
Cursor can select a skill from the task context, while the slash command menu gives the user an explicit route. The skill description is therefore part of the control surface: it should say exactly when the workflow applies and when it does not.
Safe rollout
A large bundle is harder to audit and makes it unclear which instruction changed the result. A one-skill rollout creates a clean acceptance case and exposes permission or invocation problems early.
Failure boundary
Discovery only means Cursor can see or select the workflow. It does not prove the instructions are accurate, the scripts are safe, or the connected tools have appropriate permissions.
Citation route
This page owns the broad Cursor skills hub definition. Adjacent AgentSkillsHub pages keep directory, comparison, and MCP discovery intents separate.
A Cursor skills hub is a practical way to organize Agent Skills, rules, and MCP connections by job. Agent Skills package dynamic workflows in SKILL.md files, rules provide persistent project guidance, and MCP connects Cursor to external tools and data.
Yes. Cursor announced Agent Skills support for the editor and CLI in Cursor 2.4. Skills use SKILL.md files, can be discovered when relevant, and can also be invoked from the slash command menu.
Skills package reusable procedures and domain workflows, Rules provide persistent instructions for a project or team, and MCP gives the agent access to external systems such as GitHub, browsers, databases, or ticketing tools.
Start with one narrow workflow the team can verify, such as code review, test generation, release checks, or documentation updates. Add external MCP tools only when that workflow needs data or actions outside the repository.
No. Start with one or two skills in a low-risk repository, confirm when they are invoked and what files or tools they can use, then add more only after the workflow is reliable.
Review the SKILL.md instructions and included scripts, use least-privilege credentials, keep secrets outside the repository, and test the skill with approval prompts enabled before allowing broader automation.
First-party sources
Cursor changes quickly. These first-party pages support the product facts in this guide; verify them again before a team-wide rollout.
First-party release note for Agent Skills in the editor and CLI, SKILL.md, discovery, and slash invocation.
Current product surface describing Skills as domain knowledge the agent can discover and run.
First-party explanation of Rules, dynamic Skills, and MCP-connected external tools.
The AgentSkillsHub editorial team evaluates MCP servers, Claude skills, and AI agent integrations for security, reliability, and practical deployment readiness. Every listing undergoes permission audit, README analysis, and operational risk triage before publication.