Agent-Skills.md

Agent Skills: Debug Skill

Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.

UncategorizedID: anthonylee991/gemini-superpowers-antigravity/superpowers-debug

Repository

anthonylee991/gemini-superpowers-antigravity
anthonylee991License: MIT
69384

Install this agent skill to your local

pnpm dlx add-skill https://github.com/anthonylee991/gemini-superpowers-antigravity/tree/HEAD/.agent/skills/superpowers-debug

Skill Files

Browse the full folder contents for superpowers-debug.

Download Skill

Loading file tree…

.agent/skills/superpowers-debug/SKILL.md

Skill Metadata

Name
superpowers-debug
Description
Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.

Debug Skill

When to use this skill

  • runtime errors, flaky tests, wrong outputs
  • “it used to work” regressions
  • performance or timeout problems (initial triage)

Debug workflow (do not skip steps)

  1. Reproduce
    • Capture exact error, inputs, environment, command.
  2. Minimize
    • Reduce to smallest repro (one file, one function, smallest dataset).
  3. Hypotheses (2–5)
    • Rank by likelihood.
  4. Instrument
    • Add temporary logging/assertions or use existing diagnostics.
  5. Fix
    • Smallest change that removes root cause.
  6. Prevent
    • Add regression test or permanent guard/validation.
  7. Verify
    • Run the failing case + relevant suites.

Reporting format

  • Symptom
  • Repro steps
  • Root cause
  • Fix
  • Regression protection
  • Verification