debug

Diagnose failures by applying hypothesis-driven root-cause analysis to test outputs, stack traces, and CI logs.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/0xHarbs/agent-setup --skill debug-0xharbs
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/0xHarbs/agent-setup/tree/main/claude/skills/lifecycle/debug
Command: npx skills add https://github.com/0xHarbs/agent-setup --skill debug-0xharbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured debugging workflow. Takes a failure (test output, stack trace, error log) and applies root cause analysis with for-and-against hypothesis testing. Use /debug to diagnose interactively. Use /debug --test <file> to run a test and diagnose if it fails. Use /debug --ci <url> to diagnose a CI failure from GitHub Actions. Use /debug --log <path> to analyze an error log file.

Core Features & Use Cases

  • Interactive: guide the diagnosis from an error excerpt.
  • Error parsing: extract messages, file paths, and stack frames.
  • Hypothesis-driven: generate and test root-cause hypotheses with structured for-and-against analysis.

Quick Start

Run your failure input through /debug to begin interactive diagnosis and identify the root cause.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I diagnose a root cause from a stack trace?ā–¼

Root cause analysis from a stack trace uses hypothesis-driven debugging to generate and test for-and-against theories. The Skill parses error messages, file paths, and stack frames to build a structured workflow from error capture to fix validation.

What's the best way to debug a failing CI pipeline from GitHub Actions?ā–¼

Debugging a failing CI pipeline from GitHub Actions is done by passing the CI failure URL to initiate interactive diagnosis. The Skill extracts error data from the CI logs and applies structured hypothesis testing to identify the root cause.

How does hypothesis-driven debugging work for error logs?ā–¼

Hypothesis-driven debugging for error logs works by generating potential root-cause hypotheses and evaluating evidence for and against each one. It clusters related errors across interactive sessions to verify the true failure point stepwise.

Can I run a test file and automatically diagnose the failure if it fails?ā–¼

You can run a test file and automatically diagnose the failure by passing the test file path as an argument. If the test fails, the Skill initiates the interactive root-cause analysis workflow on the resulting output.

What types of failure inputs are supported for root cause analysis?ā–¼

Supported failure inputs for root cause analysis include raw test outputs, stack traces, error log files, and GitHub Actions CI failure URLs. Each input type is parsed to extract messages and stack frames for structured diagnosis.

When should I use interactive diagnosis for error analysis?ā–¼

Interactive diagnosis for error analysis should be used when you need stepwise guidance to move from an error excerpt to a verified fix. It guides you through hypothesis generation, clustering, and validation across sessions.