debug

Capture error output, classify failure types, and trace root-cause hypotheses into a structured debug report.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/sqfzy/my_configs --skill debug-sqfzy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/sqfzy/my_configs/tree/main/claude/skills/debug
Command: npx skills add https://github.com/sqfzy/my_configs --skill debug-sqfzy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool provides a standalone root-cause tracer that captures an error, classifies it, traces the root cause, verifies hypotheses, and outputs a structured debug report. It does not implement fixes, tests, or commits. Use it to understand WHY something is broken before deciding how to fix it. Trigger when you want root-cause analysis only, such as when a user pastes an error and asks what causes it, or when you want to trace or diagnose a bug without fixing it. Do not trigger when you want the bug actually fixed (use /fix), you want to add tests (use /test), you are designing new features (use /design), or you want a design-level discussion (use /discuss).

Core Features & Use Cases

  • Error capture and classification: collects error output and categorizes the failure.
  • Root-cause tracing and hypothesis generation: presents 1–3 plausible root causes with supporting evidence.
  • Non-destructive verification and reporting: produces a structured debug report and artifacts without modifying the codebase.

Quick Start

Paste an error log or provide a path to a log file and run the tracer to generate a root-cause report.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I trace the root cause of a software error from a log file?

Root-cause analysis for software failures involves capturing error output, classifying the error type, and tracing causal paths. This process generates 1–3 plausible root-cause hypotheses supported by evidence before any fixes are implemented.

Can I diagnose a bug without modifying my codebase?

Yes, non-destructive root-cause tracing allows you to diagnose bugs without modifying your codebase. It preserves the original code and outputs a structured debug report with artifacts for review.

What is the best way to analyze why a specific module is failing?

The best way to analyze why a specific module is failing is to run a standalone root-cause tracer targeting that file or module. It captures the error, traces causal paths, and presents plausible hypotheses with supporting evidence.

Does root-cause tracing automatically execute builds and tests?

Yes, root-cause tracing can include automatic build and test execution to verify hypotheses. This helps understand why something is broken before implementing fixes, without actually modifying the codebase.

When should I use a root-cause tracer instead of an automated fix tool?

Use a root-cause tracer when you need to understand why something is broken before deciding how to fix it. Avoid using it when you want the bug actually fixed, tests added, or new features designed.