Skip to content
Engineering
Public upstreamJesse Vincent / SuperpowersPublic source

Superpowers systematic debugging

Find a reproducible root cause before changing code to fix an observed failure.

Read SKILL.md

Workflow

Superpowers’ debugging discipline separates root-cause investigation, pattern analysis, hypothesis testing and implementation, with companion debugging techniques in the original directory.

Use when

  • Diagnose a failing test, build, integration or production behavior.

Required inputs

  • Failure symptoms and reproduction steps
  • Relevant code, logs and execution environment

Expected outputs

  • Evidence-backed root cause
  • Targeted fix and regression verification

Prerequisites

  • A reproducible failure or access to an environment that exhibits it.
  • Retain the companion debugging references; do not share credentials in captured logs.

Installation

Run this command in your project after reviewing the instructions and access terms. Install complete upstream directories to keep referenced rules and scripts.

npx skills add https://github.com/obra/superpowers/tree/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/systematic-debugging --skill systematic-debugging --agent claude-code

Project file: .claude/skills/systematic-debugging/SKILL.md

Read the setup guide

Selection brief

This brief helps you choose the skill. Read the complete upstream SKILL.md and companion files for its actual instructions.

# Superpowers systematic debugging (superpowers-systematic-debugging)
Superpowers’ debugging discipline separates root-cause investigation, pattern analysis, hypothesis testing and implementation, with companion debugging techniques in the original directory.

## Use when
- Diagnose a failing test, build, integration or production behavior.

## Required inputs
- Failure symptoms and reproduction steps
- Relevant code, logs and execution environment

## Prerequisites
- A reproducible failure or access to an environment that exhibits it.
- Retain the companion debugging references; do not share credentials in captured logs.

## Expected outputs
- Evidence-backed root cause
- Targeted fix and regression verification

Source: https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/systematic-debugging/SKILL.md
Full SKILL.md: https://agenttaste.dev/skills/superpowers-systematic-debugging/SKILL.md

## Popularity evidence
- 302,164 GitHub repo stars — obra/superpowers; checked 2026-10-20. Source: https://github.com/obra/superpowers/stargazers
- 300,287 skill installs (all time) — obra/superpowers / systematic-debugging · skills.sh · all time; checked 2026-10-20. Source: https://skills.sh/obra/superpowers/systematic-debugging
Adoption counts are not user ratings or guarantees of quality.

Related skills

Browse all skills →
AgentTastePro

Claude Code Clean Architecture

Enforce strict separation between database, business logic, and UI in autonomous sessions.

Claude Code · Codex · Antigravity

SKILL.md
VercelPublic source

React best practices

Review React and Next.js code for rendering, data fetching and bundle performance.

Claude Code · Cursor · Codex · Antigravity

SKILL.mdSource ↗