Cursor — Skills
- File format
- Markdown
- Discovery path
-
.cursor/skills - Global install path
-
~/.cursor/skills - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
- Native frontmatter fields
-
name,description,license,compatibility,metadata,disable-model-invocation
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Provider field | Conversion | Canonical key | Summary |
|---|---|---|---|
compatibility | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | compatibility | yaml frontmatter key: compatibility (optional). |
description | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | description | yaml frontmatter key: description (required); documents what the skill does and when to use it. |
disable-model-invocation | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | disable_model_invocation | yaml frontmatter key: disable-model-invocation (optional bool, default false); when true, the skill is converted into an explicit slash command rather than a context-aware tool the model can auto-invoke. |
license | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | license | yaml frontmatter key: license (optional). |
metadata | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | metadata_map | yaml frontmatter key: metadata (optional map of arbitrary key/value pairs). |
name | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | display_name | yaml frontmatter key: name (required); matches the skill directory name per the Agent Skills convention. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
canonical_filename | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | SKILL.md (required, fixed name per Agent Skills convention). |
| Glob-based skill scoping | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Skills can be scoped to specific files using glob patterns, preventing irrelevant skills from being suggested during unrelated work. |
global_scope | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | ~/.agents/skills/<name>/SKILL.md and ~/.cursor/skills/<name>/SKILL.md for user-level scope; both paths are documented. |
project_scope | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | .cursor/skills/<name>/SKILL.md for Cursor-native project scope; .agents/skills/<name>/SKILL.md is also recognized via the cross-provider Agent Skills convention. |
user_invocable | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | When disable-model-invocation is true, the skill becomes an explicit slash command invocable by the user rather than auto-invoked by the model. |
| Cross-provider .agents/skills/ directory | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | Cursor also recognizes the cross-provider Agent Skills convention at .agents/skills/<name>/SKILL.md and ~/.agents/skills/<name>/SKILL.md so skills can be shared across agent harnesses. |
| Monorepo colocated skill scoping | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | In monorepos, skills placed in a package subdirectory automatically scope to that directory's context without requiring explicit path configuration. |
| Supporting file directories | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | Optional sibling files and directories alongside SKILL.md (scripts/, references/, assets/) hold executable scripts, static references, and templates used while the skill is active; resources load on-demand to maintain efficient context usage. |
| /migrate-to-skills built-in command | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Cursor 2.4 ships a built-in /migrate-to-skills command that converts existing rules and slash commands into the skills format. |
Sources
| Source |
|---|
| https://cursor.com/docs/skills |