Agent skill · software engineering · sickn33

bug-hunter

Systematically finds and fixes bugs using proven debugging techniques. Traces from symptoms to root cause, implements fixes, and prevents regression.

Why this skill is useful

Provides a structured debugging process with specific techniques and code examples that the AI wouldn't reliably generate on its own.

What it needs

About 5k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.

What this skill does

Bug Hunter Systematically hunt down and fix bugs using proven debugging techniques. No guessing—follow the evidence. When to Use This Skill User reports a bug or error Something isn't working as expected User says "fix the bug" or "debug this" Intermittent failures or weird behavior Production issues need investigation The Debugging Process 1. Reproduce the Bug First, make it happen consistently: If you can't reproduce it, gather more info: What environment? (dev, staging, prod) What browser/device? What user actions preceded it? Any error logs? 2. Gather Evidence Collect all available information: Check logs: Check error messages: Full stack trace Error type and message Line numbers Timestamp Check state: What data was being processed? What was the user trying to do? What's in the database? What's in local storage/cookies? 3. Form a Hypothesis Based on evidence, guess what's wrong: 4. Test the Hypothesis Prove or disprove your guess: Add logging: Use debugger: Isolate the problem: 5. Find Root Cause Trace back to the actual problem: Common root causes: Null/undefined values Wrong data types Race conditions Missing error handling Incorrect logic Off-by-one errors Async/await issues Missing validation Example trace: 6. Implement Fix Fix the root cause, not the symptom: Bad fix (symptom): Good fix (root cause): 7. Test the Fix Verify it actually works: 8. Prevent Regression Add a test so it doesn't come back: Debugging Techniques Binary Search Cut the problem space in half repeatedly: Rubber Duck Debugging Explain the code line by line out loud. Often you'll spot the issue while explaining. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sickn33/bug-hunter--f590e1

View the source on GitHub

Browse the @skills marketplace