bug-detective

Guide structured debugging of code errors through evidence gathering and hypothesis verification.

5|2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/Tx1207/hello-scholar --skill bug-detective-tx1207
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-detective
Source: https://github.com/Tx1207/hello-scholar/tree/main/skills/core/bug-detective
Command: npx skills add https://github.com/Tx1207/hello-scholar --skill bug-detective-tx1207

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Bug Detective Skill provides a structured debugging workflow for investigating and resolving code errors, exceptions, and failures, turning symptoms into actionable steps for quicker resolution.

Core Features & Use Cases

  • Structured debugging workflow: understand the problem, gather evidence, form hypotheses, verify hypotheses, and implement fixes.
  • Error-pattern awareness: guidance on common error types and practical triage strategies.
  • Reproducible remediation: supports repeatable debugging sessions and artifact generation for future fixes.

Quick Start

Provide the exact error message and stack trace, plus steps to reproduce, so the AI can begin a systematic debugging session.

Frequently Asked Questions about bug-detective

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a stack trace systematically instead of guessing?

Systematic debugging involves a structured workflow: understand the problem, gather evidence, form and test hypotheses, and verify fixes to resolve code errors and exceptions reproducibly.

What is the best way to troubleshoot Python or JavaScript code exceptions?

Troubleshooting code exceptions is best handled by collecting exact error messages and reproduction steps, then applying a disciplined workflow to form and test hypotheses across languages like Python and JavaScript.

Can I use this structured debugging workflow for shell script errors?

Yes, this structured debugging workflow supports software development scenarios across Python, JavaScript, and shell, guiding you through evidence gathering and hypothesis testing for shell script failures.

What information do I need to start debugging an error message?

To start debugging an error, you need to provide the exact error message, stack trace, and steps to reproduce the failure so structured evidence gathering and hypothesis testing can begin.

Why does my code keep failing after attempting a fix?

Code may keep failing if the fix was applied without verifying the root cause hypothesis; a structured debugging workflow enforces hypothesis verification and remediation guardrails to prevent this.