| name | cursor-prompting |
| description | Internal guidance for composing cursor-agent prompts and picking models for coding, review, diagnosis, and research tasks inside the Cursor Claude Code plugin |
| user-invocable | false |
Cursor Prompting
Use this skill when cursor:cursor-rescue needs to shape a request before forwarding it to cursor-agent.
Prompt Cursor like an operator, not a collaborator. Keep prompts compact and block-structured. State the task, the output contract, the follow-through defaults, and the small set of extra constraints that matter. Cursor's default auto router may hand the prompt to any model family (GPT, Claude, Grok, Composer), so avoid model-specific idioms and rely on plain structure that every family parses well.
Prompt shape:
- Lead with one sentence naming the goal and the definition of done.
- List hard constraints (files that must not change, behavior that must be preserved, tests that must pass).
- State the expected output: a diff, a diagnosis with evidence, a ranked list of findings, or a plan.
- For fixes: tell it to run the relevant tests and report the results, not just claim success.
- For diagnosis: ask for observed facts, inferences, and open questions as separate sections.
- Do not paste large file contents into the prompt — Cursor reads the workspace itself.
Model selection (only when the user asks, otherwise leave auto):
--profile deep|fast on task/rescue is a coarse, named shortcut (deep = gpt-5.6-sol-xhigh, fast = cursor-grok-4.5-high-fast) with no effort tier — Cursor has none. --model still overrides it and remains the explicit-model escape hatch.auto — Cursor's server-side router; the right default for most tasks.- Deep or adversarial reviews: a thinking model such as
claude-opus-5-thinking-high.
- Quick, tightly bounded edits: a fast Codex tier such as
gpt-5.3-codex-fast or gpt-5.3-codex-low-fast.
- Long-context work across many files: a 1M-context variant (
-high thinking models, gpt-5.6-sol-high).
- The live roster changes;
cursor-agent --list-models is the source of truth. Pass names through --model unchanged.
Mode notes:
- Reviews are requested read-only and the plugin reports any git-visible workspace drift afterward, but Cursor has no enforced read-only sandbox — never promise edits in a review prompt, and never rely on a review being unable to write.
- Write-capable tasks run with
--force under the plugin's ownership-tracked cancel — still scope the prompt to the smallest safe change.
- Resume (
--resume <chat-id>) continues an existing Cursor session with its context; write follow-up prompts as instructions to continue, not as restatements of the whole task.
