Skip to main content
Install Superpowers on Cursor using the built-in plugin marketplace. Cursor provides a streamlined installation experience through the Agent chat interface.

​
Prerequisites

  • Cursor IDE installed and running
  • Internet connection for marketplace access

​
Installation Steps

1

Open Cursor Agent

Open the Cursor Agent chat interface:
  • Use keyboard shortcut: Cmd+L (Mac) or Ctrl+L (Windows/Linux)
  • Or click the Agent icon in the sidebar
2

Install from Marketplace

In the Agent chat, run the plugin installation command:
/plugin-add superpowers
Cursor will download and activate the plugin automatically.
3

Verify Installation

Start a new Agent session and confirm Superpowers is active:
Do you have superpowers?
The agent should confirm installation and describe available skills.

​
What Gets Installed

The plugin includes:
  • Skills library - All core Superpowers skills (brainstorming, TDD, debugging, collaboration)
  • Agents - Pre-configured subagents for specialized tasks
  • Commands - Workflow automation commands
  • Hooks - Context-aware skill activation

​
Verifying Skills Work

Test automatic skill activation: 
Let's design a new feature for user profiles
The agent should automatically invoke the appropriate skill (brainstorming, writing-plans, or systematic-debugging) based on context.

​
Updating

Update to the latest version: 
/plugin-update superpowers
Cursor may prompt you to restart the Agent after updates. This ensures all changes take effect.

​
Troubleshooting

Symptom: Error when running /plugin-add superpowersSolutions:
  • Check your internet connection
  • Verify Cursor is up to date (Help → Check for Updates)
  • Try restarting Cursor IDE completely
  • Check Cursor documentation for current plugin syntax
Symptom: Agent doesn’t use Superpowers workflowsSolutions:
  • Start a fresh Agent session (Cmd+L / Ctrl+L)
  • Explicitly request a skill: “use the brainstorming skill”
  • Verify plugin is installed: check Cursor settings
  • Update the plugin: /plugin-update superpowers
Symptom: /plugin-add command not foundSolutions:
  • Ensure you’re in the Agent chat (not Composer or inline chat)
  • Update Cursor to the latest version
  • Check Cursor’s plugin documentation for syntax changes
Symptom: No difference in agent responsesSolutions:
  • Restart the Agent session completely
  • Try a task that clearly triggers a skill (e.g., “help me debug this”)
  • Check if plugin loaded: ask “what skills do you have?”
  • Reinstall: remove and add the plugin again
Cursor Agent and Cursor Composer are different interfaces. Superpowers works best in the Agent chat interface.

​
Uninstalling

To remove Superpowers from Cursor: 
/plugin-remove superpowers
Restart the Agent session for changes to take effect.

​
Platform-Specific Notes

​
Cursor Composer vs Agent

Superpowers is designed for Cursor Agent (the chat interface). While it may work in Cursor Composer, the full workflow is optimized for Agent conversations.

​
Workspace Context

Cursor Agent automatically provides workspace context to Superpowers skills. This means skills like brainstorming and writing-plans can reference your existing codebase structure.

​
Next Steps

Quick Start

Learn the basic workflow

Skills Overview

Browse available skills

Create Skills

Build custom skills

Get Help

Common issues and solutions

Build docs developers (and LLMs) love

Get started for freeTalk to us