obra/superpowers / skills/diagnosing-superpowers
diagnosing-superpowers
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.8 KB |
| prompts/analyst-common.md | markdown | 1.5 KB |
| prompts/cost-and-time.md | markdown | 1.6 KB |
| prompts/plan-adherence.md | markdown | 1.6 KB |
| prompts/quality-evidence.md | markdown | 1.4 KB |
| prompts/repeated-work.md | markdown | 1.4 KB |
| prompts/request-conflicts.md | markdown | 1011 B |
| prompts/scrub-audit.md | markdown | 1.3 KB |
| prompts/scrub.md | markdown | 1.4 KB |
| prompts/similar-session.md | markdown | 1.7 KB |
| prompts/skill-timeline.md | markdown | 1.6 KB |
| prompts/stumbles.md | markdown | 1.3 KB |
| references/context-safety.md | markdown | 990 B |
| references/github-issues.md | markdown | 1.6 KB |
| references/redaction-policy.md | markdown | 2.2 KB |
| references/session-discovery.md | markdown | 1.8 KB |
| templates/bundle-README.md | markdown | 3.6 KB |
| templates/case.md | markdown | 2.9 KB |
| templates/issue.md | markdown | 2.6 KB |
| templates/report.md | markdown | 2.3 KB |
templates/report.md
View on GitHub# Session diagnosis: <session-id>
Report path: ~/.superpowers/diagnosing-superpowers/<session-id>/report.md
Written: <ISO timestamp>
## 1. Problem statement (REQUIRED)
<Copied from the case file.>
## 2. Triage verdict (REQUIRED)
<What the evidence shows happened around the reported problem. Prose, with
`path:line` after every claim. State confidence: high / medium / low, and
what would raise it. No statement about what superpowers should do.>
## 3. Environment (REQUIRED)
- OS:
- Harness and version:
- Models seen:
- Superpowers install root / version / git sha:
- Skill files read or injected (sha1 table from the case file):
- Other plugins, extensions, MCP servers:
- Instruction files present (paths only):
Label every environment field and skill observation as historical evidence,
unverified snapshot, current observation, or unknown, and record its
supporting evidence location.
## 4. Sessions examined (REQUIRED)
| Role | Session id | Absolute path | Lines | Bytes |
|---|---|---|---|---|
Rejected candidates: <id — path — why>, or "none".
## 5. Timeline (REQUIRED)
One row per human-typed prompt. Events column lists skills invoked,
subagents dispatched, compaction, errors, resumes, aborts.
| Turn | Line | Time | Request (one line) | Events |
|---|---|---|---|---|
## 6. Findings (REQUIRED, one subsection per dimension)
Each finding:
```
- finding: <one sentence>
evidence: <path:line> — "<short quote>"
turns: <first>–<last>
confidence: high | medium | low
```
A dimension with nothing to report says `none found — checked: <what was checked>`.
### 6.1 Skill timeline
### 6.2 Plan adherence
### 6.3 Repeated work
### 6.4 Stumbles
### 6.5 Quality evidence
### 6.6 Request conflicts
### 6.7 Cost and time
### 6.8 Other plugins and skills used
## 7. Superpowers involvement (REQUIRED)
not indicated | possible | likely
Evidence lines: <path:line list>. This section states involvement only. It
does not name a defect and does not propose a change.
## 8. Coverage notes (REQUIRED)
- Not read: <ranges, files, and why>
- Harness features unavailable: <list or none>
- Session was in progress at read time: yes/no
- For your human partner to double-check: <list or none>
## 9. Similar sessions (only when requested)
| Session id | Path | Date | Harness | Matched | Did not match |
|---|---|---|---|---|---|
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| subagent-driven-developmentobra/superpowersUse when executing implementation plans with independent tasks in the current session | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |