# diagnosing-superpowers

> Claude/Codex skill by [@obra](https://omgskills.com/library/obra/index.md) · 290k stars · Updated 2026-09-20

Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.

Tags: ai, brainstorming, coding, obra, sdlc, skills, subagent-driven-development, superpowers

## Install

```sh
git clone https://github.com/obra/superpowers /tmp/superpowers && ln -s /tmp/superpowers/skills/diagnosing-superpowers ~/.claude/skills/diagnosing-superpowers
```

## From README

Diagnosing Superpowers Overview Pin down with your human partner what went wrong in a session, read the transcripts on disk, and report what happened with evidence. You report; you do not diagnose superpowers. Whoever triages the bundle or the issue decides whether superpowers changes. Core principle: Every finding cites path:line. No citation, no finding. Every number comes from the transcript or from a command you ran, never from memory. Workflow Create a todo per step. Steps 5–7 run only on their stated condition. Problem intake. Ask one question at a time until you can write a statement naming the session(s), the turn range if known, what your partner expected, what happened, and the observable they care about (wall-clock, tokens, repeated actions, one specific action). "It took too long" is a complaint, not a problem statement. Note whether the goal is a superpowers bug report. Locate.

## Links

- HTML page: https://omgskills.com/skills/obra/superpowers/diagnosing-superpowers/
- GitHub: https://github.com/obra/superpowers
- Author: [@obra](https://omgskills.com/library/obra/index.md)

## More from this repo

- [brainstorming](https://omgskills.com/skills/obra/superpowers/brainstorming/index.md) — You MUST use this before any creative work - creating features, building components, adding functionality, or modifying...
   - [@obra](https://omgskills.com/library/obra/index.md) · 289k stars
- [systematic-debugging](https://omgskills.com/skills/obra/superpowers/systematic-debugging/index.md) — Used when encountering any bug, test failure, or unexpected behavior, before proposing fixes
   - [@obra](https://omgskills.com/library/obra/index.md) · 287k stars
- [dispatching-parallel-agents](https://omgskills.com/skills/obra/superpowers/dispatching-parallel-agents/index.md) — Used when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
   - [@obra](https://omgskills.com/library/obra/index.md) · 280k stars