All skills
obra avatar

/diagnosing-superpowers

@5bf4e78 official
by Jesse Vincentobra/superpowers293k stars
26,244

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.

Use this Skill: https://skilld.dev/gh/obra/superpowers/diagnosing-superpowers

This session only. Nothing lands on disk.

templatesreport.md

≈590 tokens on demand. Your agent reads this file only when SKILL.md points to it.

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

Source: SKILL.md on GitHub

1 warning12d3 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    The skill is a diagnostic tool for analyzing AI agent session transcripts. It follows security best practices by implementing robust context-safety measures to handle large logs, mandatory PII scrubbing for data privacy, and human-in-the-loop approval gates for all data export and external reporting actions. No malicious patterns, obfuscation, or unauthorized network operations were detected.

  • Socket12d

    No alerts

  • Snyk12d

    Risk: MEDIUM · 1 issue

Signed by skilld at 5bf4e78. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated 2 weeks ago

README badge

README badge for obra/superpowers/diagnosing-superpowers