---
title: "Cursor Provider"
description: "Explains how Skillset renders adaptive and Cursor-native source into Cursor provider output."
---

> Documentation Index
> Fetch the complete documentation index at: https://nimbus.focal.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor Provider

<a id="cursor-provider"></a>

Provider id: `cursor`

Cursor is a first-class Skillset [target](/skillset/glossary/#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](/skillset/glossary/#render) project skills under `.cursor/skills/`, [adaptive rules](/skillset/reference/features/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](/skillset/glossary/#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](/skillset/glossary/#provider-native) shape into [adaptive source](/skillset/glossary/#adaptive-source) only when registry evidence proves a faithful mapping; otherwise the provider boundary stays visible and [canonical source](/skillset/glossary/#canonical-source) stays explicit.

The dated [Cursor parity fixture evidence](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/evidence/2026-09-16-cursor-parity-fixtures.md) 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](/skillset/glossary/#destination) behavior, use the feature pages for [skills](/skillset/reference/features/skills/), [rules](/skillset/reference/features/rules/), [agents](/skillset/reference/features/agents/), [plugins](/skillset/reference/features/plugins/), [hooks](/skillset/reference/features/hooks/), [MCP servers](/skillset/reference/features/mcp-servers/), and [marketplaces](/skillset/reference/features/marketplaces/).

## Feature Support

<!-- skillset:generated:start provider-feature-support -->
| Feature | Feature status | Target support | Qualification | Docs |
| --- | --- | --- | --- | --- |
| Activation Probes | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/tests-and-evals/) |
| 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](/skillset/reference/features/hooks/) |
| Changes | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/changes/) |
| Dependencies | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/dependencies/) |
| Dev Watch | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/dev-watch/) |
| Distributions | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/distributions/) |
| Feature Registry | `implemented` | `not_applicable` | — | [1](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/feature-registry.md) |
| Future Companion Source Pointers | `planned` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/apps/), [2](/skillset/reference/features/hooks/), [3](/skillset/reference/features/commands/), [4](/skillset/reference/features/settings/) |
| Marketplaces | `implemented` | `native` | — | [1](/skillset/reference/features/marketplaces/) |
| Output Safety | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/output-safety/) |
| Plugin Agents | `implemented` | `pass_through` | — | [1](/skillset/reference/features/agents/) |
| Codex Plugin Apps | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/apps/) |
| Plugin Assets | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/plugins/) |
| Plugin Bin | `implemented` | `unsupported` | Cursor plugins do not expose a documented plugin-local bin contract. | [1](/skillset/reference/features/executables/), [2](/skillset/reference/features/feature-source-pointers/) |
| Plugin Commands | `implemented` | `pass_through` | — | [1](/skillset/reference/features/commands/), [2](/skillset/reference/features/plugins/) |
| Plugin Hooks | `implemented` | `pass_through` | — | [1](/skillset/reference/features/hooks/) |
| Plugin LSP Servers | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/lsp-servers/), [2](/skillset/reference/features/plugins/) |
| Plugin Manifests | `implemented` | `native` | — | [1](/skillset/reference/features/plugins/) |
| Plugin MCP Servers | `implemented` | `native` | — | [1](/skillset/reference/features/feature-source-pointers/), [2](/skillset/reference/features/mcp-servers/) |
| Plugin Monitors | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/monitors/), [2](/skillset/reference/features/plugins/) |
| Plugin Output Styles | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/output-styles/), [2](/skillset/reference/features/plugins/) |
| Plugin README | `implemented` | `pass_through` | — | [1](/skillset/reference/features/plugins/) |
| Plugin Rules | `implemented` | `pass_through` | — | [1](/skillset/reference/features/rules/), [2](/skillset/reference/features/plugins/) |
| Plugin Scripts | `implemented` | `pass_through` | — | [1](/skillset/reference/features/plugins/) |
| Plugin Skills | `implemented` | `native` | — | [1](/skillset/reference/features/plugins/), [2](/skillset/reference/features/skills/) |
| Plugin Source | `implemented` | `pass_through` | — | [1](/skillset/reference/features/plugins/) |
| Plugin Themes | `implemented` | `planned` | cursor provider support is not registered for this feature yet. | [1](/skillset/reference/features/themes/), [2](/skillset/reference/features/plugins/) |
| Project Agents | `implemented` | `native` | — | [1](/skillset/reference/features/agents/) |
| Project Instructions | `implemented` | `transformed` | — | [1](/skillset/reference/features/rules/) |
| Releases | `implemented` | `metadata_only` | — | [1](/skillset/reference/features/releases/) |
| Render Results | `implemented` | `not_applicable` | — | [1](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/render-results.md) |
| Resources | `implemented` | `native` | — | [1](/skillset/reference/features/resources/) |
| Runtime Adapters | `planned` | `not_applicable` | — | [1](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/runtime-adapters.md) |
| Runtime Context | `implemented` | `transformed` | Normalized fields are provider, hook.event, and session.id; raw Cursor environment remains available to the hook command. | [1](/skillset/reference/features/hooks/), [2](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/hook-guardrails.md) |
| Skill Invocation Policy | `implemented` | `transformed` | — | [1](/skillset/reference/features/skills/) |
| Standalone Skills | `implemented` | `native` | — | [1](/skillset/reference/features/skills/) |
| Supports | `implemented` | `metadata_only` | — | [1](/skillset/reference/features/supports/) |
| Provider Source | `implemented` | `pass_through` | — | [1](/skillset/reference/features/target-native-islands/) |
| Tools Policy | `implemented` | `metadata_only` | Recorded as .skillset.tools.yaml metadata; no proven skill-local enforcement surface. | [1](/skillset/reference/features/tools-policy/) |
| Version Audit | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/version-audit/) |
| Workflows | `implemented` | `not_applicable` | — | [1](/skillset/reference/features/ci/), [2](/skillset/reference/features/build-scopes/), [3](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/workbench.md) |
<!-- skillset:generated:end provider-feature-support -->

## Runtime Evidence Boundary

The local Cursor CLI can smoke-test isolated renderings, but runtime evidence remains separate from compile-target support. A successful [build](/skillset/glossary/#build) does not prove that Cursor trusted, discovered, or invoked the generated artifact. See the [Cursor provider ADR](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/adrs/0002-cursor-is-a-first-class-provider.md) and [runtime adapters](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/features/runtime-adapters.md).

Skillset renders files. It does not install, trust, activate, symlink, or mutate user-level provider configuration. See [Build Versus Activation](/skillset/start/build-versus-activation/).

Source: https://nimbus.focal.host/skillset/reference/providers/cursor/index.mdx
