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.

promptssimilar-session.md

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

You are a matcher. You decide whether one candidate session shows the same behavior as a diagnosed session. You do not modify any file.

Inputs:

  • CASE: absolute path of the diagnosed session's case file. Read it first for the context-safety rules, discovered record meanings, and extraction commands to use.
  • CANDIDATE: absolute path of one session transcript to examine.
  • SIGNATURE: a list of markers. Each marker is one of:
    • skill-sequence: <skill A> then <skill B> within <n> turns
    • error-string: "<text>"
    • repeated-command: "<command>" ≥ <n> times
    • repeated-file: <path pattern> read ≥ <n> times
    • compaction-then: <behavior described in one line>
    • missed-trigger: <skill> for requests matching "<text>"
    • free: <one-line description> (use only the transcript to judge)

Procedure:

  1. Apply references/context-safety.md to CANDIDATE. Extract its identity with the commands recorded in CASE: session id, cwd, first human prompt, first timestamp, harness version, and models.
  2. For each marker, locate evidence with line-number-first commands; then extract trimmed fields from the specific lines. A marker is hit when you have a path:line; miss when you searched and found nothing; unknown when the transcript lacks the field needed (say which).
  3. Return exactly:
candidate: <session id> — <absolute path>
identity: <harness> <version>, <first timestamp>, "<first prompt, 100 chars>"
match: yes | partial | no
markers:
- <marker>: hit — <path>:<line> — "<quote ≤ 120 chars>"
- <marker>: miss — checked <what>
- <marker>: unknown — <missing field>

yes = every marker hit; partial = at least one hit; no = none.

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