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.

promptsstumbles.md

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

Read prompts/analyst-common.md first; it gives your role, inputs, context-safety rules, and the return format. This file adds the dimension.

Dimension: Stumbles

Find every point where the session stopped going forward.

Sources, each using the case file's evidenced record meanings and extraction commands to locate line numbers:

  • tool results marked as errors, non-zero exits, or explicit failure records;
  • shell commands that failed (non-zero exit in the result, "command not found", "No such file");
  • retries: the same tool call re-issued within the same turn after an error;
  • reverted edits: an edit followed by an edit that restores the earlier content, or git checkout/git restore/git revert/git reset on a file the session touched;
  • backtracking in assistant text ("actually", "let me instead", "that was wrong", "I misread");
  • human corrections: a human prompt that contradicts or corrects the assistant's immediately preceding action;
  • permission denials, hook failures, API errors, rate limits, aborted turns, and context overflow or compaction triggered mid-task.

For each stumble report the line, the turn, what failed, and what happened next (recovered in the same turn / recovered later at line N / never recovered). Group identical repeated failures into one finding with a count.

Source: SKILL.md on GitHub

1 warning13d3 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    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.

  • Socket13d

    No alerts

  • Snyk13d

    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