superpowers: Guide Coding Agents Through Software Development

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Overview

Superpowers is a framework of reusable skills and workflow instructions for coding agents. It addresses a common gap in agent-assisted development: agents may start coding before requirements are clear, skip tests, or drift from a plan.

Instead, it guides work through design, planning, implementation, review, and branch completion. It is intended for developers who want a consistent, process-driven approach across supported coding-agent tools, rather than a standalone coding agent or general-purpose application.

Key Features

Brainstorming skill to clarify requirements, explore alternatives, and validate a design before implementation.
Planning skill that breaks approved designs into small tasks with file paths and verification steps.
Test-driven development workflow based on a red, green, refactor cycle.
Task execution through subagents with reviews, or inline execution with a final review.
Skills for systematic debugging, code review, worktrees, and finishing development branches.
Integrations for multiple coding-agent harnesses, with separate installation for each.
Session diagnosis skill that can inspect a transcript and prepare a scrubbed report for a bug report.

Use Cases

A solo developer wants an agent to clarify an early-stage idea and produce a reviewable plan before changing code.
A team using coding agents wants to encourage test-first implementation and consistent review between tasks.
A developer tackling a multi-step feature wants an agent to execute a plan using subagents or work in an isolated branch.
An agent user needs to investigate why a workflow misfired or deviated during a session.

Project Facts

Language: Shell
License: MIT
Stars: 295k
Forks: 26.3k
Topics: ai, brainstorming, coding, obra, sdlc, skills, subagent-driven-development, superpowers
Archived: No

Getting Started

Install Superpowers using the method for your coding-agent harness. For Claude Code, the README lists this command:

/plugin install superpowers@claude-plugins-official

See the README for other integrations, setup details, and update instructions.

Alternatives

agent-skills: It offers portable engineering workflows, while Superpowers packages a structured methodology for supported agent tools.
skills: It provides composable skills for specific practices rather than Superpowers' end-to-end development workflow.
compound-engineering-plugin: It guides work through brainstorming, implementation, review, and captured learnings, with support for several agent hosts.

Considerations

Superpowers provides workflows and skills, not a coding model or standalone agent. You need a compatible coding-agent harness and must install it for each harness you use.
Its workflow is deliberately prescriptive, including mandatory skills and test-driven development. That can add process overhead when a task is small or exploratory.
The README says contributions of new skills are generally not accepted, and skill changes must work across supported agents.
Optional visual-companion telemetry loads a versioned logo from the project's website. The README says it does not include project or prompt details and can be disabled with SUPERPOWERS_DISABLE_TELEMETRY.