skb3002/agenthub/systematic-debugging

Claude Code and agent skill by skb3002/agenthub

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.

Install

npx vskill@latest install skb3002/agenthub/systematic-debugging

SKILL.md

Systematic Debugging

Source: obra/superpowers

Overview

This skill provides a structured approach to debugging that prevents random guessing and ensures problems are properly understood before solving.

4-Phase Debugging Process

Phase 1: Reproduce

Before fixing, reliably reproduce the issue.

markdown
## Reproduction Steps
1.[Exact step to reproduce]
2.[Next step]
3.[Expected vs actual result]
 
## Reproduction Rate
-[ ] Always (100%)
-[ ] Often (50-90%)
-[ ] Sometimes (10-50%)
-[ ] Rare (<10%)
Phase 2: Isolate

Narrow down the source.

markdown
## Isolation Questions
-When did this start happening?
-What changed recently?
-Does it happen in all environments?
-Can we reproduce with minimal code?
-What's the smallest change that triggers it?
Phase 3: Understand

Find the root cause, not just symptoms.

markdown
## Root Cause Analysis
### The 5 Whys
1.Why: [First observation]
2.Why: [Deeper reason]
3.Why: [Still deeper]
4.Why: [Getting closer]
5.Why: [Root cause]
Phase 4: Fix & Verify

Fix and verify it's truly fixed.

markdown
## Fix Verification
-[ ] Bug no longer reproduces
-[ ] Related functionality still works
-[ ] No new issues introduced
-[ ] Test added to prevent regression

Debugging Checklist

markdown
## Before Starting
-[ ] Can reproduce consistently
-[ ] Have minimal reproduction case
-[ ] Understand expected behavior
 
## During Investigation
-[ ] Check recent changes (git log)
-[ ] Check logs for errors
-[ ] Add logging if needed
-[ ] Use debugger/breakpoints
 
## After Fix
-[ ] Root cause documented
-[ ] Fix verified
-[ ] Regression test added
-[ ] Similar code checked

Common Debugging Commands

bash
# Recent changes
git log --oneline -20
git diff HEAD~5
 
# Search for pattern
grep -r "errorPattern" --include="*.ts"
 
# Check logs
pm2 logs app-name --err --lines 100

Anti-Patterns

❌ Random changes - "Maybe if I change this..." ❌ Ignoring evidence - "That can't be the cause" ❌ Assuming - "It must be X" without proof ❌ Not reproducing first - Fixing blindly ❌ Stopping at symptoms - Not finding root cause

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
3
7-day trend score
7

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/skb3002/agenthub/systematic-debugging/badge)](https://verified-skill.com/skills/skb3002/agenthub/systematic-debugging)

Something wrong with this skill or its page? Tell us.