Skip to main content
Install Superpowers on Claude Code using the built-in plugin marketplace. Claude Code provides the most streamlined installation experience with automatic updates.

​
Prerequisites

  • Claude Code installed and running
  • Internet connection for marketplace access

​
Installation Steps

1

Register the Marketplace

First, register the Superpowers marketplace in Claude Code:
/plugin marketplace add obra/superpowers-marketplace
This gives Claude Code access to the Superpowers plugin repository.
2

Install the Plugin

Install Superpowers from the marketplace:
/plugin install superpowers@superpowers-marketplace
Claude Code will download and activate the plugin automatically.
3

Verify Installation

Start a new chat session and test that Superpowers is active:
Do you have superpowers?
The agent should confirm that Superpowers is installed and list available skills.

​
What Gets Installed

The plugin includes:
  • Skills library - All core Superpowers skills (brainstorming, TDD, debugging, etc.)
  • Agents - Pre-configured subagents for code review and implementation
  • Commands - Slash commands for common workflows
  • Hooks - Automatic skill activation based on context

​
Verifying Skills Are Active

Try triggering a skill automatically: 
Help me plan a new authentication feature
The agent should automatically load the relevant skill (brainstorming, systematic-debugging, or requesting-code-review) based on your request.

​
Updating

Update to the latest version at any time: 
/plugin update superpowers
Skills and workflows update automatically through the marketplace.

​
Troubleshooting

Symptom: Error when adding the marketplaceSolutions:
  • Check your internet connection
  • Verify the marketplace name: obra/superpowers-marketplace
  • Try removing and re-adding: /plugin marketplace remove obra/superpowers-marketplace
Symptom: Error during /plugin installSolutions:
  • Ensure the marketplace is registered first
  • Check Claude Code version is up to date
  • Try specifying the full name: superpowers@superpowers-marketplace
Symptom: Agent doesn’t use Superpowers skillsSolutions:
  • Start a fresh chat session (skills load at session start)
  • Explicitly mention a skill: “use brainstorming skill”
  • Verify plugin is active: /plugin list
  • Check for plugin updates: /plugin update superpowers
Symptom: /plugin command not recognizedSolutions:
  • Update Claude Code to the latest version
  • Check Claude Code documentation for current plugin syntax
  • Verify you’re in a chat session, not a file editor
Plugin installation is permanent across Claude Code sessions. You only need to install once.

​
Uninstalling

To remove Superpowers: 
/plugin uninstall superpowers
To also remove the marketplace: 
/plugin marketplace remove obra/superpowers-marketplace

​
Next Steps

Quick Start

Learn the basic Superpowers workflow

Skills Reference

Explore all available skills

Customize

Create your own skills

Troubleshooting

Common issues and solutions