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 |
references/github-issues.md
View on GitHub# GitHub issues
Use `gh` when it is installed and authenticated; it handles auth, rate
limits, and JSON. Fall back to the public API with curl, then to a URL
your partner opens.
## Search
```bash
gh search issues --repo obra/superpowers --limit 10 "<terms>" \
--json number,state,title --jq '.[] | "\(.number)\t\(.state)\t\(.title)"'
```
Without `gh` (unauthenticated, 10 requests a minute):
```bash
curl -s -H "Accept: application/vnd.github+json" \
"https://api.github.com/search/issues?q=repo:obra/superpowers+is:issue+<url-encoded terms>&per_page=10" \
| jq -r '.items[] | "\(.number)\t\(.state)\t\(.title)"'
```
Without curl, hand over `https://github.com/obra/superpowers/issues?q=<terms>`.
## File
Write the filled `templates/issue.md` to the workspace and show the exact
text. After approval:
```bash
gh issue create --repo obra/superpowers --title "<title>" --body-file <path> \
--label bug --label automated-issue-report
```
GitHub drops labels silently when the reporter lacks push access, so the
labels land only for collaborators; the template footer still marks the
issue as skill-filed. `gh` cannot attach files: give your partner the
bundle path to attach through the browser after the issue exists.
Without `gh`, hand over a prefilled link on the `bug_report.md` template,
which applies the `bug` label for any reporter:
```
https://github.com/obra/superpowers/issues/new?template=bug_report.md&title=<url-encoded title>&body=<url-encoded body>
```
GitHub rejects URLs over about 8,000 characters; past that, send the link
with the title only and tell your partner to paste the body from the file.
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: 471k | 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 |