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

Build docs developers (and LLMs) love

Get started for freeTalk to us