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.

referencessession-discovery.md

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

Discover the session history

Resolve the session your human partner named using the tools and information available in this environment. Your knowledge can suggest where to look; verify the result against the actual history.

Use the harness's exposed session tools, configured storage, local help, documentation, or bounded filesystem inspection. Measure files before reading their content and follow context-safety.md. Inspect archives or indexes when the environment points to them. A supplied usable path does not need another search.

Confirm identity using the available session id, working directory, timestamps, and matching conversation content. Recency alone is not confirmation. Distinguish the requested session from its children and unrelated candidates. Ask for a missing identifying fact when the available evidence cannot distinguish them.

For each filesystem source, obtain its full absolute path from the environment, with home-directory shorthand and variables expanded. Use that same path in the case record and in the discovery answer you give your human partner.

Establish the record meanings needed for the requested investigation from observed records or documentation. Distinguish human messages from injected messages, tool results, and a parent agent's dispatch. Match tool calls to their results. Establish usage-counter semantics before calculating totals. Do not infer a format from another harness or turn a missing field into a zero.

Record the exact sources, relevant field meanings, supporting record locations, associated sessions, rejected plausible candidates, and unresolved information in the case file. Subsequent readers use that record rather than repeating discovery. If history is missing, inaccessible, or ambiguous, state the specific limitation and ask for the missing path, export, or identifying detail.

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 last week.

Activeupdated 2 weeks ago

README badge

README badge for obra/superpowers/diagnosing-superpowers