> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/obra/superpowers/llms.txt
> Use this file to discover all available pages before exploring further.

# Install on Claude Code

> Install Superpowers on Claude Code via the plugin marketplace

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

<Steps>
  <Step title="Register the Marketplace">
    First, register the Superpowers marketplace in Claude Code:

    ```bash theme={null}
    /plugin marketplace add obra/superpowers-marketplace
    ```

    This gives Claude Code access to the Superpowers plugin repository.
  </Step>

  <Step title="Install the Plugin">
    Install Superpowers from the marketplace:

    ```bash theme={null}
    /plugin install superpowers@superpowers-marketplace
    ```

    Claude Code will download and activate the plugin automatically.
  </Step>

  <Step title="Verify Installation">
    Start a new chat session and test that Superpowers is active:

    ```text theme={null}
    Do you have superpowers?
    ```

    The agent should confirm that Superpowers is installed and list available skills.
  </Step>
</Steps>

## 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:

<CodeGroup>
  ```text Feature Planning theme={null}
  Help me plan a new authentication feature
  ```

  ```text Bug Investigation theme={null}
  This function is crashing intermittently
  ```

  ```text Code Review theme={null}
  Review my recent changes
  ```
</CodeGroup>

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:

```bash theme={null}
/plugin update superpowers
```

Skills and workflows update automatically through the marketplace.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Marketplace registration fails">
    **Symptom:** Error when adding the marketplace

    **Solutions:**

    * Check your internet connection
    * Verify the marketplace name: `obra/superpowers-marketplace`
    * Try removing and re-adding: `/plugin marketplace remove obra/superpowers-marketplace`
  </Accordion>

  <Accordion title="Plugin installation fails">
    **Symptom:** Error during `/plugin install`

    **Solutions:**

    * Ensure the marketplace is registered first
    * Check Claude Code version is up to date
    * Try specifying the full name: `superpowers@superpowers-marketplace`
  </Accordion>

  <Accordion title="Skills not activating automatically">
    **Symptom:** Agent doesn't use Superpowers skills

    **Solutions:**

    * 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`
  </Accordion>

  <Accordion title="Command not found errors">
    **Symptom:** `/plugin` command not recognized

    **Solutions:**

    * 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
  </Accordion>
</AccordionGroup>

<Note>
  Plugin installation is permanent across Claude Code sessions. You only need to install once.
</Note>

## Uninstalling

To remove Superpowers:

```bash theme={null}
/plugin uninstall superpowers
```

To also remove the marketplace:

```bash theme={null}
/plugin marketplace remove obra/superpowers-marketplace
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/getting-started/quick-start">
    Learn the basic Superpowers workflow
  </Card>

  <Card title="Skills Reference" icon="book" href="/skills/overview">
    Explore all available skills
  </Card>

  <Card title="Customize" icon="sliders" href="/customization/personal-skills">
    Create your own skills
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/troubleshooting">
    Common issues and solutions
  </Card>
</CardGroup>