debug

Diagnose software failures with an evidence-first workflow and structured Debug Report output.

156|37|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/zeuikli/claude-code-workspace --skill debug-zeuikli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/zeuikli/claude-code-workspace/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/zeuikli/claude-code-workspace --skill debug-zeuikli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps you systematically debug bugs and failures by turning ambiguous errors into a clear root cause and a minimal, verified fix.

Core Features & Use Cases

  • 6-Step Debug Workflow: Capture evidence, isolate scope, form hypotheses, test with proof, apply the smallest fix, and verify the outcome to prevent regressions.
  • Evidence-First Diagnosis: Uses log inspection, error pattern detection, and cross-system correlation (including request_id and time windows) to avoid guessing.
  • Debug Report Output: Produces a structured report with Issue, Root Cause, Evidence, Fix, Verification, and Prevention—ideal for commit messages and postmortems.
  • Use Cases: Debugging test failures, production anomalies (error spikes), application crashes (stack traces), timeout and connection errors, and resource issues like OOM.

Quick Start

Use the debug skill to analyze the failing stack trace, search the relevant logs for error patterns, propose 2-3 hypotheses, validate them with targeted commands, then produce a Debug Report with root cause, minimal fix, and verification steps.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I find the root cause of a production incident from ambiguous error logs?

To find the root cause of production incidents, capture error evidence from logs, isolate the scope using request_id and time windows, form hypotheses, and validate them with targeted commands to generate a structured Debug Report.

What is the best way to debug test failures without guessing?

The best way to debug test failures is using an evidence-first workflow that inspects logs, detects error patterns, proposes hypotheses, tests them with concrete command-based validation, and applies minimal fixes to prevent regressions.

How do I systematically fix application crashes and stack trace errors?

To systematically fix application crashes and stack trace errors, analyze the failing stack trace, search relevant logs for error patterns, validate 2-3 hypotheses with targeted commands, and apply the smallest fix before verifying the outcome.

Can I use this evidence-first workflow for diagnosing timeout and connection errors?

Yes, you can use this evidence-first workflow to diagnose timeout, connection, and resource-limit issues like OOM by cross-correlating system logs and applying structured command-based validation to verify the root cause.

How do I document a root cause analysis for a postmortem or commit message?

You document root cause analysis for postmortems by generating a structured Debug Report that includes the Issue, Root Cause, Evidence, Fix, Verification, and Prevention steps derived from the systematic debugging workflow.

What should I do when my application logs show error spikes but no clear failure point?

When logs show error spikes without a clear failure point, isolate the scope by cross-correlating request_id and time windows, test hypotheses with concrete commands, and output a Debug Report to pinpoint the minimal fix.