superpowers debug
- Repo stars 774
- Author repo gemini-superpowers-antigravity
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @anthonylee991 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
Sections and files
Listed in source order.
sections -> When to use this skill → Debug workflow (do not skip steps) → Reporting format
terms -> Reproduce · Minimize · Hypotheses (2–5) · Instrument · Fix · Prevent · Verify
files/cmd -> logging/assertions · guard/validation.
body sha256 -> e8404261f72f
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)
Reproduce Capture exact error, inputs, environment, command. Minimize Reduce to smallest repro (one file, one function, smallest dataset). Hypotheses (2–5)
Reporting format
Symptom Repro steps Root cause Fix Regression protection