Skip to content

Cursor Provider

Explains how Skillset renders adaptive and Cursor-native source into Cursor provider output.

Updated

Provider id: cursor

Cursor is a first-class Skillset target, not a Claude or Codex compatibility shim. It participates in the default provider plan, and repositories can narrow output through explicit compile.targets configuration.

Provider Shape

Skillset renders project skills under .cursor/skills/, adaptive rules as .cursor/rules/**/*.mdc with globs derived from each rule’s directory and paths (unescaped, since Cursor documents no escape for [, ], ( or )), project agents under .cursor/agents/, and plugin bundles with a native .cursor-plugin/plugin.json manifest as generated output. Cursor plugin output can include rules, skills, agents, commands, hooks, and MCP configuration. Marketplace source can render a Cursor-owned .cursor-plugin/marketplace.json index after explicit readiness checks and update confirmation.

Cursor has no verified project SessionStart hook destination, so Skillset does not invent one. When Cursor is enabled, compile.session_start_hook: auto still checks whether its project skill output root is gitignored before enabling the Claude and Codex advisory entries. This does not change Cursor’s separate plugin-hook support.

Cursor-native source remains available under explicit _cursor/ paths. Skillset lifts a provider-native shape into adaptive source only when registry evidence proves a faithful mapping; otherwise the provider boundary stays visible and canonical source stays explicit.

The dated Cursor parity fixture evidence records the official pages and hashes behind current path claims, along with the named gaps later authoring-model work must close.

For exact source and destination behavior, use the feature pages for skills, rules, agents, plugins, hooks, MCP servers, and marketplaces.

Feature Support

Feature Feature status Target support Qualification Docs
Activation Probes implemented not_applicable — 1
Adaptive Hooks implemented degraded Cursor supports plugin-level command hooks, but has no faithful skill-local or project-agent hook destination and uses provider-native lower-camel event names. 1
Changes implemented not_applicable — 1
Dependencies implemented planned cursor provider support is not registered for this feature yet. 1
Dev Watch implemented not_applicable — 1
Distributions implemented not_applicable — 1
Feature Registry implemented not_applicable — 1
Future Companion Source Pointers planned planned cursor provider support is not registered for this feature yet. 1, 2, 3, 4
Marketplaces implemented native — 1
Output Safety implemented not_applicable — 1
Plugin Agents implemented pass_through — 1
Codex Plugin Apps implemented planned cursor provider support is not registered for this feature yet. 1
Plugin Assets implemented planned cursor provider support is not registered for this feature yet. 1
Plugin Bin implemented unsupported Cursor plugins do not expose a documented plugin-local bin contract. 1, 2
Plugin Commands implemented pass_through — 1, 2
Plugin Hooks implemented pass_through — 1
Plugin LSP Servers implemented planned cursor provider support is not registered for this feature yet. 1, 2
Plugin Manifests implemented native — 1
Plugin MCP Servers implemented native — 1, 2
Plugin Monitors implemented planned cursor provider support is not registered for this feature yet. 1, 2
Plugin Output Styles implemented planned cursor provider support is not registered for this feature yet. 1, 2
Plugin README implemented pass_through — 1
Plugin Rules implemented pass_through — 1, 2
Plugin Scripts implemented pass_through — 1
Plugin Skills implemented native — 1, 2
Plugin Source implemented pass_through — 1
Plugin Themes implemented planned cursor provider support is not registered for this feature yet. 1, 2
Project Agents implemented native — 1
Project Instructions implemented transformed — 1
Releases implemented metadata_only — 1
Render Results implemented not_applicable — 1
Resources implemented native — 1
Runtime Adapters planned not_applicable — 1
Runtime Context implemented transformed Normalized fields are provider, hook.event, and session.id; raw Cursor environment remains available to the hook command. 1, 2
Skill Invocation Policy implemented transformed — 1
Standalone Skills implemented native — 1
Supports implemented metadata_only — 1
Provider Source implemented pass_through — 1
Tools Policy implemented metadata_only Recorded as .skillset.tools.yaml metadata; no proven skill-local enforcement surface. 1
Version Audit implemented not_applicable — 1
Workflows implemented not_applicable — 1, 2, 3

Runtime Evidence Boundary

The local Cursor CLI can smoke-test isolated renderings, but runtime evidence remains separate from compile-target support. A successful build does not prove that Cursor trusted, discovered, or invoked the generated artifact. See the Cursor provider ADR and runtime adapters.

Skillset renders files. It does not install, trust, activate, symlink, or mutate user-level provider configuration. See Build Versus Activation.

Type to search…

↑↓ navigate↵ selectEsc close