Skills
Superpowers
Jesse Vincent’s skill framework: plan, write tests, then let the agent change code.
Superpowers, maintained by obra (Jesse Vincent), is a set of agent skills and a software-development method. It splits ordinary work into brainstorming a design, writing a plan, writing tests first, implementing, and reviewing. The repository is MIT licensed.
It fits people already using Claude Code, Cursor, or Codex who do not want the agent to edit files immediately. Install it from the repository instructions and try it on a small task to see whether it stops to plan.
This page is a guide, not the original text.
Note (verified 15 November 2026): The repository is not archived. The latest release is v7.0.2 (06:17 Asia/Shanghai on 4 November 2026). For Claude Code, the current install path is the official plugin marketplace command /plugin install superpowers@claude-plugins-official (https://claude.com/plugins/superpowers). This project has not been replaced by official Agent Skills. It is known to conflict with Claude Code tool changes; see issues #2177, #2699, and #2701. As of 8 November 2026, some posts still recommend the older command npx skills add obra/superpowers.
What problem it solves
obra/superpowers is a set of agent skills and a software-development method maintained by Jesse Vincent (obra). It is meant to stop a coding agent from editing files at once: the agent should first draw out the design, write a plan a later implementer can follow, implement in a test-driven way, and review between tasks. The repository is MIT licensed and is not archived.
Verified on 2026-11-16 (Asia/Shanghai). The latest GitHub Release is v7.0.2, published at 22:17 UTC on 3 November 2026, which is 06:17 Asia/Shanghai on 4 November 2026. The most recent repository push was at 07:24 Asia/Shanghai on 4 November 2026. This catalog has moved the entry off the featured list and added a warning, because the install path has changed and because there is known friction with some coding tools—not because the project has been abandoned. It has also not been replaced by Anthropic’s official Agent Skills mechanism: Claude Code can still install it from the official plugin marketplace.
Who it is for
It is for people already using Claude Code, Cursor, Codex, or another harness listed in the README, who do not want the agent to start editing immediately. The official workflow emphasizes design, planning, and then implementation, so it is a poor fit for a tiny change that should just edit one file.
The README gives a separate install path for each harness and says that if you use more than one, you should install Superpowers separately for each. This guide focuses on the official commands for Claude Code, Cursor, and Codex CLI. For other tools, follow the current README; do not reuse one harness’s command on another.
How to install it
The commands below come from the repository README as checked on 2026-11-16. Do not use the older command npx skills add obra/superpowers, which still appears in some posts.
Claude Code
The documented path is Anthropic’s official plugin marketplace:
/plugin install superpowers@claude-plugins-officialYou can also register the Superpowers marketplace and install from there:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplaceCursor
In Cursor Agent chat:
/add-plugin superpowersYou can also search for “superpowers” in the plugin marketplace.
Codex CLI
The README points to the official Codex plugin marketplace. Open the plugin search interface:
/pluginsThen search for superpowers and choose Install Plugin. In the Codex app, add Superpowers from Plugins in the sidebar, in the Coding section.
After install, try a small, disposable task and see whether the agent stops to discuss the design instead of writing files immediately. How updates arrive depends on the harness; the README only says updates are often automatic and does not give one upgrade command for every tool.
A worked example
In the Muse install notes, the README uses a fresh session with the prompt Let's make a react todo list as a check that the install is working: a working install should trigger brainstorming before any code is written. This guide did not run that prompt, so it does not invent the questions the agent would ask or the design document it would write.
- Install with the official command for the harness you actually use. Do not mix in the older
npxcommand. - Start a fresh session in an empty practice directory and send that prompt, or a similarly small practice task of your own.
- Expected effect (from the official wording, not from a run on this machine): the agent should clarify the design and ask you to approve it, rather than create project files at once.
- If it starts editing immediately, do not widen the task. The README suggests asking the agent to “figure out what went wrong with superpowers in this session.” Review any later diff yourself.
Common pitfalls
- Following an old tutorial and running
npx skills add obra/superpowers. The README checked on 2026-11-16 gives/plugin installfor Claude Code. - Reading “it is in the official marketplace” as “it has no friction with current Claude Code.” Issue #2177 was still open on 2026-11-16. It was last updated at 20:00 UTC on 22 October 2026 (04:00 Asia/Shanghai on 23 October 2026). It reports that, starting with Claude Code 2.1.233, some current models no longer expose
TodoWrite/Task*by default, while Superpowers skills still instructed the agent to use those tools. The report was filed against Superpowers 6.3.0 and Claude Code 2.1.235. The issue’s workaround is to setCLAUDE_CODE_ENABLE_TODO_TOOLSto"1"in theenvblock of~/.claude/settings.json. v7.0.2 has shipped since then. This guide did not re-test the issue on 7.0.2, so it does not claim that the problem is fixed or that it still reproduces. - Issue #2699 was still open on 2026-11-16. It was created at 19:58 Asia/Shanghai on 14 November 2026 and is filed against v7.0.2. It argues that forceful wording in
using-superpowerscan over-trigger skills on current Claude models. That is a user report, not an official confirmation. - If you use OpenCode: issue #2701 was still open on 2026-11-16 (created at 20:46 Asia/Shanghai on 14 November 2026). It says the plugin’s OpenCode v2 tool mapping incorrectly claims there is “no todo tool,” which does not match the real
todowritetool whenexperimental.todois enabled. This guide did not reproduce that on OpenCode. - The optional visual companion loads a logo from the maintainers’ site by default and includes the Superpowers version. Official docs say this does not include project, prompt, or harness details. You can turn it off with
SUPERPOWERS_DISABLE_TELEMETRY. Superpowers also honors Claude Code’sDISABLE_TELEMETRYandCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.
FAQ
Has Superpowers been replaced by official Agent Skills?
No. The README checked on 2026-11-16 still points Claude Code at /plugin install superpowers@claude-plugins-official and at claude.com/plugins/superpowers. This catalog moved the entry off the featured list because install instructions go stale easily and because the open issues above exist, not because an official mechanism has replaced the project.
What is the current Claude Code install command?
Use the command in the current README: /plugin install superpowers@claude-plugins-official. Do not treat the older npx skills add obra/superpowers as the current official command.
What is the latest version?
As of 2026-11-16, the latest GitHub Release is v7.0.2, published at 06:17 Asia/Shanghai on 4 November 2026. If the version on your machine differs, check that Releases page rather than a third-party tutorial.
Why does the agent say TodoWrite or Task tools are missing?
Issue #2177 (still open) describes this and documents an environment-variable workaround. It was filed against 6.3.0 and the Claude Code version then in use. This guide did not re-test after v7.0.2, so it cannot say whether the same setting is still required or whether the problem is gone. Read the current discussion on that issue and the official README first.
What is the license? Can I use it commercially?
The repository is MIT licensed; see LICENSE. Read the full text before commercial use or redistribution. The README also mentions enterprise support at [email protected]; that is separate from the open-source license, and this page does not discuss commercial terms.
Sources and license
The obra/superpowers repository is licensed under MIT. This page is a paraphrase, for CQBase — Context & Query Base, of the README, the v7.0.2 release notes, the official plugin page, and issues #2177, #2699, and #2701, which were still open when checked on 2026-11-16. If install commands or known issues change, the repository and the official plugin page win.
In this category
- Skills
Anthropic Agent Skills
Anthropic’s public skill repository, useful as a reference for how SKILL.md is written.
anthropics - Skills
Addy Osmani’s agent skills
Engineering skills for coding agents, aimed at code you can keep rather than a one-shot generation.
addyosmani - Skills
Impeccable
A design vocabulary for coding agents, so feedback can be specific instead of “make it nicer.”
pbakaus