porcupine-md/jonggrang/debugging-systematically
Claude Code and agent skill by porcupine-md/jonggrang
- community
Checking that the SKILL.md file is still in the repository.
Systematic debugging methodology. Reproduce → Isolate → Hypothesize → Verify → Fix → Confirm.
Install
npx vskill@latest install porcupine-md/jonggrang/debugging-systematicallySKILL.md
The 6-Step Debugging Protocol
Step 1: Reproduce Reliably
Before anything else, make the bug reproducible.
If you can't write a reproducible test, you don't understand the bug yet.
Step 2: Read the Error
Read the FULL error message + stack trace. Most bugs tell you exactly where they are.
Checklist:
- What file and line number?
- What was the actual value vs expected?
- Is there an inner error wrapped in the outer one?
Step 3: Narrow the Scope (Binary Search)
Add console.log / breakpoints to establish:
- What inputs enter the broken function?
- What does the function actually return?
Step 4: Form a Hypothesis
State your hypothesis explicitly:
"I believe the bug is caused by [X] because [evidence Y]."
Common hypotheses:
- Off-by-one error
- Async/await missing (uncaught promise)
- Null/undefined not handled
- Type coercion (== vs ===)
- Race condition
- Stale cache/state
Step 5: Verify (Don't Fix Yet)
Prove your hypothesis is correct BEFORE fixing:
If the hypothesis is wrong, go back to Step 3.
Step 6: Fix and Confirm
- Apply the minimal fix
- Run the reproduction test — it should now pass
- Run the full test suite — nothing should break
- Write a regression test if one didn't exist
Common Bug Patterns
Async bugs:
Null propagation:
Race condition:
Tools
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/library/backend/debugging-systematically/SKILL.md
Popularity
- Repository stars
- 14
- Repository forks
- 3
- 7-day trend score
- 19
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
[](https://verified-skill.com/skills/porcupine-md/jonggrang/debugging-systematically)