Superpowers

An agentic skills framework & software development methodology that works.

201,283
Stars
17,933
Forks
784
Subscribers

Quickstart

Give your agent Superpowers:

Claude Code

Install via marketplace

Codex CLI

Install from marketplace

Codex App

Install in app

Factory Droid

Install plugin

Gemini CLI

Install extension

OpenCode

Fetch instructions

Cursor

Install from marketplace

GitHub Copilot CLI

Install plugin

How It Works

1

Understanding Your Goal

When you start building something, your agent doesn't jump into code. It steps back and asks what you're really trying to do.

2

Spec Refinement

Your agent teases out a specification in chunks short enough to read and digest, presenting it for your approval.

3

Implementation Planning

With your approval, it creates a clear implementation plan emphasizing TDD, YAGNI, and DRY principles.

4

Subagent-Driven Development

Launches a process with agents working through each task, inspecting and reviewing their work autonomously.

The Basic Workflow

brainstorming

Activates before writing code. Refines ideas through questions and presents design sections for validation.

using-git-worktrees

Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.

writing-plans

Breaks work into bite-sized tasks with exact file paths, complete code, and verification steps.

subagent-driven-development

Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality).

test-driven-development

Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass.

requesting-code-review

Reviews against plan, reports issues by severity. Critical issues block progress.

finishing-a-development-branch

Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.

What's Inside

Testing

  • test-driven-development - RED-GREEN-REFACTOR cycle with anti-patterns reference

Debugging

  • systematic-debugging - 4-phase root cause process
  • verification-before-completion - Ensure it's actually fixed

Collaboration

  • brainstorming - Socratic design refinement
  • writing-plans - Detailed implementation plans
  • executing-plans - Batch execution with checkpoints
  • dispatching-parallel-agents - Concurrent subagent workflows
  • requesting-code-review - Pre-review checklist
  • receiving-code-review - Responding to feedback
  • using-git-worktrees - Parallel development branches
  • finishing-a-development-branch - Merge/PR decision workflow
  • subagent-driven-development - Fast iteration with two-stage review

Meta

  • writing-skills - Create new skills following best practices
  • using-superpowers - Introduction to the skills system

Philosophy

Test-Driven Development

Write tests first, always

Systematic over ad-hoc

Process over guessing

Complexity reduction

Simplicity as primary goal

Evidence over claims

Verify before declaring success

Sponsorship

If Superpowers has helped you do stuff that makes money and you are so inclined, I'd greatly appreciate it if you'd consider sponsoring my opensource work.

Installation

Claude Code

Available via official Claude plugin marketplace

/plugin install superpowers@claude-plugins-official

Codex CLI

Available via official Codex plugin marketplace

/plugins → search: superpowers → Install Plugin

Codex App

Available via official Codex plugin marketplace

Plugins → Coding section → Click + next to Superpowers

Factory Droid

Register marketplace and install plugin

droid plugin marketplace add https://github.com/obra/superpowers

droid plugin install superpowers@superpowers

Gemini CLI

Install extension

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

OpenCode

Tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Cursor

In Cursor Agent chat:

/add-plugin superpowers

GitHub Copilot CLI

Register marketplace and install plugin

copilot plugin marketplace add obra/superpowers-marketplace

copilot plugin install superpowers@superpowers-marketplace