debugging

Generate markdown debug reports documenting root cause, fix, and lessons learned.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/DojoGenesis/gateway --skill debugging-dojogenesis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/DojoGenesis/gateway/tree/main/plugins/continuous-learning/skills/debugging
Command: npx skills add https://github.com/DojoGenesis/gateway --skill debugging-dojogenesis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill produces structured Debug Reports to identify root causes, document fixes, and capture lessons after systematic hypothesis-driven testing, reducing time to resolution and preventing regressions.

Core Features & Use Cases

  • Structured Debug Reports: Generates markdown reports with Error Message, Stack Trace, Root Cause, Solution, Code Changes, Test Results, and Lessons Learned.
  • Hypothesis-driven workflow: Guides information gathering, hypothesis formulation, isolated testing, and verification steps to confirm root causes.
  • Debugging patterns: Recommends targeted log inspection, binary search, environment isolation, git bisect, and reproducible test cases.
  • Use Cases: Fix runtime errors, diagnose performance regressions, resolve data inconsistencies, troubleshoot integration failures, and investigate intermittent production issues.

Quick Start

Provide a concise error description and any relevant logs to generate a debug report documenting root cause, fix applied, and lessons learned.

Frequently Asked Questions about debugging

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

FAQPage Schema
How do I generate a debug report from stack traces and logs?

To generate a debug report, provide a clear error description and relevant logs. The system applies hypothesis testing to isolate variables and outputs a markdown report documenting the root cause, applied fix, and lessons learned.

What is the best way to troubleshoot intermittent production issues and data inconsistencies?

Troubleshooting intermittent production issues and data inconsistencies requires hypothesis-driven testing. By isolating variables and inspecting targeted logs, you can verify reproducible test cases and confirm the root cause before applying fixes.

Can I use hypothesis testing to diagnose performance regressions without specific dependencies?

Yes, you can diagnose performance regressions using hypothesis testing without specific dependencies. The workflow guides information gathering, environment isolation, and binary search to identify the root cause directly from reproducible tests.

How do I document root cause analysis and code changes for runtime errors?

Documenting root cause analysis for runtime errors produces a structured markdown report. This report includes the error message, stack trace, isolated root cause, solution, code change references, test results, and lessons learned.

Does troubleshooting integration failures require reproducible test cases?

Yes, troubleshooting integration failures effectively requires reproducible test cases. These cases verify the isolated variables, confirm the identified root cause, and validate that the applied fix resolves the integration failure.

What debugging patterns work for isolating variables during root cause analysis?

Effective debugging patterns for isolating variables during root cause analysis include targeted log inspection, binary search, environment isolation, and git bisect. These patterns systematically narrow down hypotheses to pinpoint the exact failure.