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.

promptsplan-adherence.md

≈410 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: Plan adherence

Recover the plan the session agreed to, then map each plan step to what happened. "Plan" here means any agreed course of action, not git commits.

  1. Find the agreed plan: a design or plan agreed in chat (look for the assistant text preceding a human "yes/ok/go ahead"), a spec or plan file written during the session (tool calls that write under docs/, plans/, specs/, or any file the human named), a todo-list record whose meaning was established in the case file, or any numbered checklist in assistant text. Quote each plan step with its path:line.
  2. Mark structural events between the plan and its execution: compaction events identified during discovery, resumes, aborted turns, and associated session dispatches. Note their line numbers; plan drift right after one of these is a distinct finding.
  3. For each plan step, find the tool calls and assistant text that executed it, or establish that none did. Report:
    • steps skipped (no execution found; quote the plan step);
    • steps executed out of order (line numbers show the order);
    • steps silently changed (execution differs from the plan step in a way the assistant never announced; quote both);
    • steps invented (work done that no plan step covers);
    • drift immediately after a structural event (cite the event line and the first divergent action).
  4. If there is no recoverable plan, say so as the only finding, with the lines you checked.

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