debugger

Isolate root causes across network, process, config, dependencies, data, and code layers.

Updated Nov 22, 2025
One-click install
npx skills add https://github.com/Khamel83/oneshot --skill debugger-khamel83
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugger
Source: https://github.com/Khamel83/oneshot/tree/main/archive/v9/skills/debugger
Command: npx skills add https://github.com/Khamel83/oneshot --skill debugger-khamel83

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically identify and diagnose issues by isolating causes through structured, evidence-based steps.

Core Features & Use Cases

  • Structured triage: triage intent, reproduce issues, and isolate root causes across layers (network, process, config, dependencies, data, code).
  • Evidence-based diagnosis: gather symptoms, reproduce steps, and test hypotheses with minimal changes.
  • Reproducibility and documentation: record steps, findings, and final fix rationale for future reference.

Quick Start

Describe the first steps I should take to start debugging a reported issue.

Frequently Asked Questions about debugger

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

FAQPage Schema
How do I systematically troubleshoot and isolate the root cause of a software issue?

To systematically troubleshoot a software issue, the debugger skill isolates potential causes across layers like network, process, config, dependencies, data, and code. It reproduces the issue to determine the root cause and proposes a structured fix plan with clear verification steps.

What is the best way to reproduce a reported bug for evidence-based diagnosis?

The best way to reproduce a bug for evidence-based diagnosis is to gather user-reported symptoms and systematically triage the intent. By isolating layers and testing hypotheses with minimal changes, you can reliably reproduce the issue and document the findings.

How do I diagnose whether a failure is caused by network, config, or code dependencies?

To diagnose whether a failure stems from network, config, or code dependencies, you systematically isolate each layer to reproduce the issue. Structured triage identifies the root cause through evidence-based steps, testing hypotheses across layers before applying a fix.

Can I use structured debugging to propose a fix plan with verification steps?

Yes, you can use structured debugging to propose a fix plan with verification steps. After systematically isolating layers and reproducing the issue to find the root cause, the process outputs a documented fix plan with clear verification steps and rationale for future reference.

Why should I document the rationale and outcome of a root-cause analysis?

You should document the rationale and outcome of a root-cause analysis to provide evidence-based diagnosis records for future reference. Documenting reproducible symptoms, isolated layers, and the final fix rationale ensures structured triage outcomes are preserved for subsequent troubleshooting.

What should I do when my initial bug reproduction steps fail to isolate the root cause?

When initial bug reproduction steps fail to isolate the root cause, systematically expand your triage across remaining layers like network, process, config, dependencies, data, and code. Gather more symptoms, test new hypotheses with minimal changes, and document findings to pinpoint the issue.