cursor-agent
Run Cursor Agent CLI for coding tasks — writing, editing, refactoring, reviewing, or planning code — without spending OpenClaw API credits. Use when the user asks to write/fix/refactor/review code, a coding task would otherwise be done inline with Sonnet/Haiku, the user says "do this in cursor" or "use cursor for this", or any substantial file-editing task in a known repo. NOT for conversational questions about code (answer inline) or tiny one-liners that don't warrant a subprocess.
Best use case
cursor-agent is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Run Cursor Agent CLI for coding tasks — writing, editing, refactoring, reviewing, or planning code — without spending OpenClaw API credits. Use when the user asks to write/fix/refactor/review code, a coding task would otherwise be done inline with Sonnet/Haiku, the user says "do this in cursor" or "use cursor for this", or any substantial file-editing task in a known repo. NOT for conversational questions about code (answer inline) or tiny one-liners that don't warrant a subprocess.
Teams using cursor-agent should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/cursor-agent-openclaw/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How cursor-agent Compares
| Feature / Agent | cursor-agent | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Run Cursor Agent CLI for coding tasks — writing, editing, refactoring, reviewing, or planning code — without spending OpenClaw API credits. Use when the user asks to write/fix/refactor/review code, a coding task would otherwise be done inline with Sonnet/Haiku, the user says "do this in cursor" or "use cursor for this", or any substantial file-editing task in a known repo. NOT for conversational questions about code (answer inline) or tiny one-liners that don't warrant a subprocess.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# Cursor Agent Cursor Agent CLI runs on the user's Cursor subscription — zero API cost. Always prefer it over inline code generation for any non-trivial coding task. ## Prerequisites **Required binary: `agent`** (Cursor Agent CLI) Install from the official site: https://cursor.com/docs/cli/overview — then verify with `agent --version`. The helper script (`scripts/run.sh`) will exit with an error if `agent` is not found in PATH. ## User Consent Required — MANDATORY This skill MUST NOT be invoked autonomously. Every invocation requires: 1. **State intent first** — tell the user: the repo, the task, the model, and whether files will be changed 2. **Wait for explicit "yes"** — do not proceed without clear user approval 3. **Default to read-only** — use `run.sh <repo> <task> <model> ask` unless the user explicitly asks for changes 4. **Before writing files** — run in `ask` mode first, show the user the plan, then ask: *"Apply these changes?"* 5. **Before `--cloud`** — explicitly warn: *"This will send repo contents to cursor.com. OK to proceed?"* 6. **Before committing** — show the diff and get confirmation The helper script (`scripts/run.sh`) defaults to `ask` (read-only). Pass `write` as the mode argument only after the user has confirmed changes should be applied. ## Model Routing | Task type | Model flag | Mode flag | |---|---|---| | Trivial / exploratory | *(omit — `auto`)* | *(omit)* | | Bug fix / feature / refactor | `--model sonnet-4.6` | *(omit)* | | Code review / explain (read-only) | `--model sonnet-4.6` | `--mode=ask` | | Architecture / design planning | `--model opus-4.6-thinking` | `--mode=plan` | | Long background task | `--model sonnet-4.6` | use `--cloud` instead of `-p` | ## Headless Commands **Read-only first** — always start with `--mode=ask` to review before applying changes: ```bash cd <repo> && agent -p "<task>" --model sonnet-4.6 --mode=ask --output-format text --trust ``` **Apply changes** — only after user confirms the plan: ```bash cd <repo> && agent -p "<task>" --model sonnet-4.6 --force --output-format text --trust ``` **Cloud/background** — warn user that repo data goes to cursor.com: ```bash cd <repo> && agent -c "<task>" --model sonnet-4.6 --trust # Monitor at: cursor.com/agents ``` ## Git Rule Cursor sandbox blocks `git commit`. Always commit manually after Cursor edits: ```bash cd <repo> && git add -A && git commit -m "<conventional commit message>" && git push ``` Show the diff to the user and confirm before committing if the change is large or touches sensitive areas. ## Repos & Workdirs - Always `cd` to the correct repo before running - Check for `.cursor/rules` and `AGENTS.md` in the repo root — Cursor loads these automatically for project context ## Context & Sessions - Add `@<file>` in prompt to include specific files in context - `--continue` or `--resume` to continue a previous session - `agent ls` to list previous sessions ## Output Handling - `--output-format text` → clean final answer, summarise key changes to the user - `--output-format json` → structured, use for scripted parsing - Always report back: what changed, what was committed, any issues found ## References - Model list & details: `references/models.md` - Slash commands (interactive mode): `references/slash-commands.md`
Related Skills
cursor2api
cursor2api proxy service management tool that converts Cursor IDE's free AI conversations into Anthropic Messages API / OpenAI Chat Completions API format. Supports Docker deployment, environment configuration, token refresh, and complete uninstallation. Use when user asks to: (1) Install or deploy cursor2api, (2) Configure cursor2api for OpenClaw/Claude Code/CC Switch, (3) Refresh or retrieve Cursor Session Token, (4) Uninstall cursor2api.
clawdcursor
OS-level desktop automation tool server. 42 tools for controlling any application on Windows, macOS, and Linux. Model-agnostic — works with any AI that can do function calling via REST or MCP (Claude, GPT, Gemini, Llama, Mistral, or plain HTTP). No built-in LLM in serve/mcp mode. You are the brain. ClawdCursor is the hands.
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.
botlearn-healthcheck
botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.
linkedin-cli
A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.