What Is the Claude Code 'Superpowers' Plugin? Installation and Cautions

Superpowers is not an official Anthropic feature — it's a third-party open-source plugin (plugin — an add-on package that extends a program's features) built by a developer named obra and published on GitHub. Installing it on Claude Code layers an entire development methodology on top: turning a request into a spec, drafting an implementation plan, and carrying it through to actual code. This article is based on the README in the obra/superpowers GitHub repository and Claude Code's official documentation (code.claude.com/docs).

What exactly is Superpowers?

Superpowers is a "software development methodology" made up of multiple skills (skill — an instruction set Claude automatically pulls in for a given task context) plus initial instructions that make sure those skills actually get used. According to the repository, here's how it works: as soon as it notices you're building something, Claude doesn't jump straight into code. It first asks what you're really trying to do. Once that conversation produces a spec (spec — a written description of what to build), Claude shows it back to you in chunks short enough to actually read, and waits for your sign-off. After you approve, it puts together an implementation plan — one the repository says should be clear enough for "an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing" to follow. Once you say go, a subagent-driven development process begins: subagents (subagent — a helper agent that independently handles a specific task) work through the plan step by step, inspecting and reviewing each other's work before moving on. The repository notes that it's not uncommon for this process to run autonomously for a couple of hours at a time without deviating from the plan.

The repository says this methodology leans on TDD (Test-Driven Development — writing a failing test first, then writing the code that makes it pass; the README calls this "red/green TDD"), YAGNI (You Aren't Gonna Need It — don't build functionality you don't need yet), and DRY (Don't Repeat Yourself — avoid duplicating the same code or logic). Note that Superpowers isn't Claude Code-exclusive — the repository also documents installation for Antigravity, Codex, Cursor, Devin CLI, Gemini CLI, and other coding agents. This article covers only the Claude Code installation path.

What do you need before you start?

• Claude Code installed and authenticated — the only prerequisite Claude Code's official documentation lists for using plugins.
• A terminal where you can run Claude Code — the commands below are typed into the chat that opens once Claude Code is running, not into a plain shell.
• An internet connection — registering the marketplace and installing the plugin both pull data from a GitHub repository.

Neither the repository nor Claude Code's official documentation mentions any plan restriction (Free, Pro, Max, etc.), so this article doesn't claim a specific plan is required.

Quick terms to know

• Plugin — a package that bundles skills, agents, hooks (hook — an action that runs automatically at a specific point), and MCP servers into Claude Code.
• Marketplace — a catalog of plugins. Per Claude Code's official docs, you must add the marketplace a plugin belongs to before you can install that plugin.
• Skill — an instruction document Claude automatically references for a given task context.
• Subagent — a helper agent that handles a specific task independently of the main conversation.

How do you install it? Pick one of two paths

According to the repository, Superpowers can be installed two ways, and both end up installing the same plugin: through Anthropic's official marketplace (claude-plugins-official), or by registering Superpowers' own marketplace. Type every command below into the chat that opens once Claude Code is running.

Path A: install from the official marketplace

1. Start Claude Code.
2. Type this command into the chat.

   /plugin install superpowers@claude-plugins-official

3. Per Claude Code's official documentation, you'll then be asked to pick an installation scope: User, Project, or Local. For personal use, User scope is the simplest choice.
4. You'll know it worked when the install summary shows "Plugin is now active." — you're ready to go. If it shows "Run /reload-plugins to activate." instead, run /reload-plugins as instructed.

Path B: install from the Superpowers marketplace

1. Register the marketplace first.

   /plugin marketplace add obra/superpowers-marketplace

2. Once that's done, install the plugin from it.

   /plugin install superpowers@superpowers-marketplace

3. Scope selection and the success signal are the same as Path A.

Note: exact command syntax and menu names can shift slightly between Claude Code versions. If what you see on screen differs from this article, trust the screen.

Common snags after installing, and how to fix them

• "Unknown command" or /plugin doesn't show up at all
  Your Claude Code version is probably out of date. Run claude --version to check, and if you installed via npm, update with npm install -g @anthropic-ai/claude-code@latest, then restart your terminal. This is the fix order the official docs recommend.
• Installed, but the skills don't appear
  The official docs say to clear the cache with rm -rf ~/.claude/plugins/cache, restart Claude Code, and reinstall.
• An environment (like a cloud session) says /plugin isn't available
  Per the official docs, use the plugin browser in the Claude desktop app instead, or declare the plugin under enabledPlugins in your project's .claude/settings.json.
• Installed, but nothing seems to have changed
  Check whether the install summary said "Run /reload-plugins to activate." — if so, run /reload-plugins.

What to keep in mind before installing

• It isn't officially supported. obra/superpowers is built and maintained by an individual developer, not Anthropic. If something goes wrong, the repository's own issue tracker — not Claude Code support — is the right place to ask.
• Plugins are highly trusted components. Claude Code's official documentation warns that "plugins and marketplaces are highly trusted components that can execute arbitrary code on your machine with your user privileges," and to only install from sources you trust.
• Path B skips a review step. Plugins listed in Anthropic's community marketplace (claude-community) go through automated validation and safety screening. Registering a repository directly as its own marketplace — Path B, obra/superpowers-marketplace — is a separate route that doesn't go through that process.
• Autonomous runs can be long. The repository notes that subagents commonly run for a couple of hours at a time without deviating from the plan. The first time you try it, it's worth watching the results rather than stepping away.

Frequently asked questions

Q. Is Superpowers an official Anthropic plugin?
No. It's a third-party open-source project built by a developer named obra and published on GitHub (obra/superpowers). The repository says it can also be installed from Anthropic's official marketplace, but Anthropic doesn't build or maintain it.

Q. Which install path should I use — the official marketplace or the Superpowers marketplace?
The repository documents both, and they install the same plugin. The difference is that the Superpowers marketplace path registers a marketplace the repository runs itself, which doesn't go through the review process that Anthropic's community marketplace applies.

Q. I installed it, but the command doesn't run.
First check that Claude Code is up to date — the official docs say to run claude --version and update if it's old. If that doesn't fix it, the docs also cover clearing the cache (rm -rf ~/.claude/plugins/cache) and reinstalling.

Q. Can I use it with tools other than Claude Code?
Yes. The repository documents installation for Antigravity, Codex, Cursor, Devin CLI, Gemini CLI, and other coding agents, so it isn't built exclusively for Claude Code.

Superpowers is a third-party plugin maintained by its own repository, not a Claude Code feature — so the first thing to check before installing is whether you trust the source. The installation itself is just one or two commands, but since subagents can then run autonomously for a while, it's worth watching the first run closely before letting it go unattended.

Related articles

• Claude Code Skills (Agent Skills) Guide: Extend Claude with SKILL.md
• Learning from Claude Skill Examples: anthropics/skills Patterns
• Claude Code Skill Not Recognized — Troubleshooting Guide
• Claude Code Installation Guide: native vs npm, Windows Included
• Claude Code vs Cursor: Key Differences and Which to Choose