# Superpowers

Source: https://trendhub.net/skills/obra-superpowers
Repository: https://github.com/obra/superpowers
Author: Jesse Vincent (https://github.com/obra)
License: MIT
GitHub stars: 318,572

Superpowers is a set of composable skills plus a short bootstrap that turns a coding agent into a disciplined collaborator: it clarifies intent, writes a plan, builds with test-first habits and reviews, then wraps up the branch. It suits developers who want structured, autonomous sessions and installs as a plugin in Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI and other agents.

## What problems it solves

- **Agents start coding before they understand the request**: The brainstorming skill pauses to ask about goals, compares approaches and gets a written design approved before anything is built.
- **Long tasks drift away from the plan**: Plans are split into small tasks with exact file paths and checks, then executed task by task with a review after each one.
- **Fixes that are guessed rather than proven**: Test-first development, root-cause debugging and a verification step require evidence before the agent reports success.
- **Hard to tell why a session went wrong**: A diagnosing skill reads the session transcript, explains what happened with evidence and can prepare a scrubbed bug report.

## Install

### Claude Code

From Anthropic's official plugin marketplace.

```
/plugin install superpowers@claude-plugins-official
```

### Claude Code (Superpowers marketplace)

Alternative marketplace that also lists related plugins.

```
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

### Codex CLI

Search for superpowers in the plugin list and choose Install Plugin; the Codex app has the same entry under Plugins.

```
/plugins
```

### Cursor

Run in Cursor Agent chat, or search the plugin marketplace.

```
/add-plugin superpowers
```

### Gemini CLI

Update later with gemini extensions update superpowers.

```
gemini extensions install https://github.com/obra/superpowers
```

### GitHub Copilot CLI

Registers the marketplace, then installs the plugin.

```
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace
```

### Devin CLI

Update with devin plugins update superpowers.

```
devin plugins install obra/superpowers
```

### Qwen Code

Pick superpowers when prompted.

```
qwen extensions install obra/superpowers
```

### Pi

Loads the skills plus a small extension that injects the bootstrap at session start.

```
pi install git:github.com/obra/superpowers
```

### Antigravity

Run the same command again to update.

```
agy plugin install https://github.com/obra/superpowers
```

Install separately for each agent you use, restart open sessions, and check it works by asking for a small project: the brainstorming skill should start before any code is written.

## Skills

Skill names are shown as /name. Depending on the agent, a skill runs when it is relevant or when you call it by name; plugin installs may add a prefix.

- `/brainstorming`: Clarifies what you want and why, then gets a design approved before building. (https://trendhub.net/skills/obra-superpowers/brainstorming.markdown)
- `/diagnosing-superpowers`: Analyzes a session transcript to explain what went wrong, with optional bug report. (https://github.com/obra/superpowers/tree/main/skills/diagnosing-superpowers)
- `/dispatching-parallel-agents`: Splits independent tasks across several subagents that work at the same time. (https://github.com/obra/superpowers/tree/main/skills/dispatching-parallel-agents)
- `/executing-plans`: Carries out an implementation plan inline in one session, with a final review. (https://github.com/obra/superpowers/tree/main/skills/executing-plans)
- `/finishing-a-development-branch`: Checks tests, then offers to merge, open a PR, keep or discard the branch. (https://github.com/obra/superpowers/tree/main/skills/finishing-a-development-branch)
- `/receiving-code-review`: Evaluates review feedback critically and verifies it before changing any code. (https://github.com/obra/superpowers/tree/main/skills/receiving-code-review)
- `/requesting-code-review`: Asks a reviewer to check finished work against the plan and requirements. (https://github.com/obra/superpowers/tree/main/skills/requesting-code-review)
- `/subagent-driven-development`: Runs a plan by sending each task to a fresh subagent, reviewing each result. (https://trendhub.net/skills/obra-superpowers/subagent-driven-development.markdown)
- `/systematic-debugging`: Finds the root cause of a bug in four phases before attempting a fix. (https://github.com/obra/superpowers/tree/main/skills/systematic-debugging)
- `/test-driven-development`: Enforces writing a failing test first, then minimal code, then cleanup. (https://trendhub.net/skills/obra-superpowers/test-driven-development.markdown)
- `/using-git-worktrees`: Creates an isolated branch workspace, runs setup and confirms tests pass first. (https://github.com/obra/superpowers/tree/main/skills/using-git-worktrees)
- `/using-superpowers`: Teaches the agent to look for and load matching skills before responding. (https://github.com/obra/superpowers/tree/main/skills/using-superpowers)
- `/verification-before-completion`: Requires running checks and reading their output before claiming work is done. (https://github.com/obra/superpowers/tree/main/skills/verification-before-completion)
- `/writing-plans`: Turns an approved spec into small tasks with file paths, code and checks. (https://github.com/obra/superpowers/tree/main/skills/writing-plans)
- `/writing-skills`: Guides creating, editing and testing new skills before they are used. (https://github.com/obra/superpowers/tree/main/skills/writing-skills)

## Questions

### Is Superpowers free to use?

Yes. The repository is released under the MIT license. Prime Radiant offers optional paid support for enterprise teams.

### Which coding agents does it support?

The README covers Claude Code, Codex app and CLI, Cursor, Gemini CLI, GitHub Copilot CLI, Devin CLI, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent, Antigravity and Muse. Each agent needs its own install.

### How do I update it?

It depends on the agent and is often automatic; several agents have an explicit update command, such as gemini extensions update superpowers or devin plugins update superpowers.

## Before you install

The skills let the agent run shell commands, edit files, run tests, create git worktrees and commits, and dispatch subagents; merges, pushes and filing GitHub issues are gated on your approval. The optional brainstorming visual companion loads a logo from Prime Radiant's site that reports the Superpowers version, which you can turn off with SUPERPOWERS_DISABLE_TELEMETRY.
