Debugging Wizard

Diagnose software errors using systematic root-cause analysis and testing.

Updated Oct 22, 2025
One-click install
npx skills add https://github.com/franroa/chezmoi --skill debugging-wizard-franroa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debugging Wizard
Source: https://github.com/franroa/chezmoi/tree/main/private_dot_config/opencode/skills/debugging-wizard
Command: npx skills add https://github.com/franroa/chezmoi --skill debugging-wizard-franroa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill applies a systematic debugging methodology to isolate root causes and resolve issues efficiently across languages and frameworks.

Core Features & Use Cases

  • Reproduce & isolate: Establish steps and narrow down failing cases.
  • Hypothesize & test: Form testable theories and validate them.
  • Prevent regressions: Add tests and safeguards after fixes.

Quick Start

Outline a debugging plan for a failing Java service: reproduce, isolate, hypothesize, test, fix, and prevent.

Frequently Asked Questions about Debugging Wizard

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

FAQPage Schema
How do I debug errors systematically across different programming languages?

Systematic debugging isolates root causes by reproducing the issue, gathering complete error messages and stack traces, testing hypotheses one at a time, and verifying fixes. This approach works across any language or framework by following consistent steps: reproduce, isolate, hypothesize, test, fix, and validate with regression tests.

What's the best way to analyze stack traces and log files to find the root cause?

Root-cause analysis from stack traces and logs involves gathering complete error output, identifying where the failure occurs in the call chain, and tracing backward through log context. Testing one hypothesis at a time against the evidence narrows the search space and prevents chasing false leads.

How do I diagnose performance issues and memory leaks in my code?

Performance debugging and memory leak diagnosis follow the same systematic methodology: reproduce the degradation, isolate the affected component, form testable theories about resource usage, and validate fixes. Documentation of findings and regression tests prevent recurrence.

Can I debug race conditions and concurrent errors with this approach?

Yes, race-condition resolution applies the systematic debugging framework: establish reproducible conditions, gather complete error traces, test isolation hypotheses, implement fixes, and add tests to catch regressions. Concurrent bugs often require repeated testing to confirm solutions.

What should I do after fixing a bug to prevent it from happening again?

After implementing a fix, verify the outcome, add regression tests that would catch the same error, and remove any debug traces before release. Documentation of the root cause and solution prevents similar issues in future development.

Do I need special tools or frameworks to debug code systematically?

Systematic debugging methodology applies across any tech stack without special dependencies. The approach—reproduce, isolate, hypothesize, test, fix, verify, and add tests—works with standard debugging tools, logs, and error messages available in any language or framework.