repowiseobra/superpowers

obra / superpowers

An agentic skills framework & software development methodology that works.

Shell★ 303,256
Use in your agentAsk this codebase

github.com/obra/superpowersIndexed at 3dcbd5cUp to date with upstream

What is superpowers?

superpowers is a software development methodology for coding agents. It guides agents through requirements discovery, design approval, planning, implementation, testing, review, and branch completion using composable skills and initial instructions. The repository is primarily written in Shell, with JavaScript, TypeScript, and Python files.

Written by a model from the README and the source

162 files and 327 symbols in 6 modules, led by Shell (42 files) and JavaScript (13).

Start reading

Code health

7.6out of 10Good

This codebase scores 7.6 out of 10 for code health, which we rate good. It also scores maintainability 8.7 and static performance 9.8 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 12 of 162 files are git hotspots, and they average 6.2 — which is where the fixes pay off most.

Full health report

Use obra/superpowers in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/obra/superpowers
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is superpowers put together?")
  • get_why("why is superpowers structured this way?")

Explore superpowers

Key features of superpowers

  • superpowers guides coding agents from rough ideas through design, planning, implementation, testing, review, and branch completion.
  • The brainstorming workflow refines ideas through questions, explores alternatives, presents designs in sections, and saves a design document.
  • The writing-plans workflow creates bite-sized tasks with exact file paths, complete code, and verification steps.
  • The test-driven-development workflow enforces RED-GREEN-REFACTOR during implementation.
  • The subagent-driven-development workflow dispatches a fresh subagent per task and uses two-stage review for specification compliance and code quality.
  • The finishing-a-development-branch workflow verifies tests and presents options for completing the branch.

How obra/superpowers works

superpowers begins when a coding agent detects that a user is building something and uses the brainstorming skill to clarify the goal and produce a design. The using-git-worktrees skill creates an isolated workspace after design approval, while writing-plans turns the design into small tasks with file paths and verification steps. The subagent-driven-development and executing-plans skills carry out those tasks, with review and human checkpoints. The test-driven-development skill applies a RED-GREEN-REFACTOR cycle during implementation. The requesting-code-review skill checks work against the plan, and finishing-a-development-branch verifies tests and handles the completed branch. The skills directory holds the workflow skills, tests holds test files, docs holds documentation, and scripts/sync-to-codex-plugin.sh and scripts/package-codex-plugin.sh support Codex plugin packaging.

The codebase has 162 files and 327 symbols in 6 modules, led by Shell, JavaScript and TypeScript. Code health is 7.6 out of 10, rated good.

Getting started with superpowers

  1. Install the plugin for Claude Code from the official marketplace.
    /plugin install superpowers@claude-plugins-official
  2. For local Pi development, load the checkout as a temporary package.
    pi -e /path/to/superpowers

Commands copied from the README

obra/superpowers FAQ

What is superpowers?

superpowers is a software development methodology for coding agents. It combines composable skills and initial instructions to guide work from requirements discovery through branch completion.

How does superpowers work?

superpowers activates relevant skills during coding-agent sessions. The workflow clarifies requirements, validates a design, creates a plan, executes tasks with reviews, applies test-driven development, and verifies the finished branch.

How do I install superpowers?

superpowers is installed separately for each coding-agent harness. Claude Code uses a plugin command, Antigravity uses agy plugin install, and Pi uses pi install.

What language is superpowers written in?

superpowers is primarily written in Shell. The repository also includes JavaScript, TypeScript, and Python files.

How is the superpowers code organized?

superpowers organizes workflow skills in skills, tests in tests, documentation in docs, and packaging utilities in scripts. The repository also includes hooks and .claude-plugin.

Who is superpowers for?

superpowers is for people using coding agents to develop software. It provides mandatory workflows for clarifying ideas, planning tasks, implementing with tests, reviewing changes, and finishing branches.

What license does superpowers use?

superpowers uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of obra/superpowers from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.