debug

Diagnose software issues through a structured six-step debugging workflow.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cmtkdot/arc --skill debug-cmtkdot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/cmtkdot/arc/tree/main/skills/debug
Command: npx skills add https://github.com/cmtkdot/arc --skill debug-cmtkdot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging using the persona-debugger agent methodology. Apply six steps to find and fix the root cause.

Core Features & Use Cases

  • Reproduce: Understand and reproduce the issue from the given input
  • Isolate: Narrow down the root cause path and gather evidence
  • Analyze: Read relevant sources, logs, and state to identify failure modes
  • Hypothesize: Form theories about the root causes and rank by likelihood
  • Test: Validate hypotheses with strategic debug output and assertions
  • Fix: Implement the minimal fix and verify with regression checks

Quick Start

Describe the issue and reproduce it using the steps above, then follow the six-step debugger process to identify and fix the root cause.

Frequently Asked Questions about debug

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

FAQPage Schema
What is a systematic debugging workflow for root cause analysis?

Systematic debugging applies a six-step workflow to reproduce, isolate, analyze, hypothesize, test, and fix software issues. This methodology uses evidence collection to identify failure modes across code, logs, and runtime environments.

How do I troubleshoot a software issue using a structured debugging process?

Start troubleshooting by reproducing the issue, then isolate the root cause path and gather evidence. Analyze relevant sources and logs, form hypotheses ranked by likelihood, test them with assertions, and implement a minimal fix with regression checks.

What's the best way to reproduce and isolate a bug from runtime logs?

The best way to isolate a bug is to reproduce it from the given input, then narrow down the root cause path by analyzing runtime logs and state. This structured process ensures you collect evidence before forming root cause hypotheses.

Do I need any specific dependencies or components to use the six-step debugging method?

No dependencies or components are required. The six-step debugging method is applied directly to your code, logs, and runtime environments to generate a final report without needing external tools.

Why does forming a hypothesis help fix software bugs faster?

Forming a hypothesis helps fix bugs faster by ranking potential root causes by likelihood. You then test these theories with strategic debug output and assertions to validate the exact failure mode before implementing a minimal fix.

What are the limitations of systematic debugging for complex runtime environments?

Systematic debugging relies on your ability to reproduce the issue and gather evidence from logs and runtime state. If a problem cannot be reproduced or lacks sufficient evidence, the six-step workflow may fail to isolate the root cause.