cursor-agent
About This Skill
A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).
~/.zshrc (zsh) or ~/.bashrc (bash): source ~/.zshrc (or ~/.bashrc) agent (primary) and cursor-agent (backward compatible) agent ls agent resume Use Cases
agent --version agent --version or cursor-agent --version agent --resume="[chat-id]" /rules** - Create and edit rules directly from CLI /commands** - Create and modify custom commands Shift+Enter** - Add newlines for multi-line prompts Documentation (Original)
Source: README.mdCursor CLI Agent Skill
This repository contains the definition and documentation for the cursor-agent skill, updated for 2026 features.
Overview
The cursor-agent skill encapsulates workflows and commands for the Cursor CLI, enabling efficient AI-pair programming directly from the terminal. This skill includes all modern features from the January 2026 update.
What's New in v2.0.0
- Model Switching: Switch between AI models with
agent models,--modelflag, and/modelscommand - MCP Management: Enable/disable MCP servers on the fly with
/mcp enableand/mcp disable - Rules & Commands: Create and edit rules directly from CLI with
/rulesand/commands - Modern Command Interface: Use
agentas the primary command (backward compatible withcursor-agent) - Enhanced Headless Mode: New flags including
--force,--output-format json, and--stream-partial-output - Interactive Features: Context selection with
@, slash commands, and keyboard shortcuts - Cross-Platform Support: Complete instructions for macOS (including Homebrew), Linux/Ubuntu, and Windows WSL
Contents
- SKILL.md: The core skill definition file containing all commands, workflows, and usage instructions
- README.md: This file, providing an overview and quick reference
Quick Start
Install the Cursor CLI:
# Standard installation (macOS, Linux, WSL)
curl https://cursor.com/install -fsS | bash
# Homebrew (macOS only)
brew install --cask cursor-cli
Authenticate:
agent login
Start an interactive session:
agent
Switch models:
agent models
Usage
Refer to SKILL.md for comprehensive instructions on:
- Installation and authentication
- Interactive and non-interactive modes
- Model switching and configuration
- MCP server management
- Rules and commands creation
- Slash commands and keyboard shortcuts
- Workflows for code review, refactoring, debugging, and CI/CD integration
Security Audit
Summary
A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).
ToxicSkills Analysis
No Toxic signals detected by current static checks.
Key Risks 0 items
Deterministic Findings (Evidence)
| Rule | Severity | File | Snippet |
|---|---|---|---|
| QUALITY_README_PRESENT | low | README Line n/a | README detected |
Scoring Criteria
Each skill is scored across 5 dimensions. The weighted total determines the star rating.
Star Rating Scale
Why This Score?
All dimensions scored above 60. This skill passed the safety baseline.