debug

Guide structured root-cause debugging with evidence collection and hypothesis testing.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/lleontor705/cortex-ia --skill debug-lleontor705
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/lleontor705/cortex-ia/tree/main/internal/assets/skills/debug
Command: npx skills add https://github.com/lleontor705/cortex-ia --skill debug-lleontor705

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic root-cause debugging that identifies the true origin of bugs before proposing fixes, reducing wasted effort and regressions.

Core Features & Use Cases

  • Structured investigation protocol that collects evidence, forms testable hypotheses, and validates fixes.
  • Phase-based workflow (investigate, diagnose, fix) with explicit success criteria and guardrails.
  • ReAct-style guidance including how to reproduce, gather logs, and trace data flow to origin.

Quick Start

Initiate a debugging session following the Phase 1–3 workflow to locate the root cause and verify the fix.

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 bug before applying a fix?

Root-cause debugging identifies the true origin of bugs before proposing fixes, reducing wasted effort and regressions. It guides evidence collection, hypothesis testing, and targeted fixes through a structured investigation protocol.

What is the best way to debug errors across multi-component systems and CI pipelines?

Debugging multi-component systems and CI pipelines works best with a phase-based workflow that automates evidence collection, forms testable hypotheses, and validates fixes. It guides you to reproduce errors, gather artifacts, and trace data flow to the origin.

How do I systematically investigate and reproduce errors in software projects?

Systematic error investigation follows a phase-based workflow with explicit success criteria and guardrails. You reproduce errors, gather logs and artifacts, form explicit hypotheses, and trace data flow to isolate the origin before testing a single targeted fix.

Does structured root-cause debugging require explicit hypotheses and single-change testing?

Yes, structured root-cause debugging requires explicit hypotheses and single-change testing to validate fixes. It enforces a ReAct-style protocol that gathers logs and traces data flow, satisfying requirements for comprehensive investigation documentation.

Why should I use a phase-based investigation workflow instead of immediately patching bugs?

A phase-based investigation workflow prevents wasted effort and regressions by locating the true origin of bugs before fixes. It separates investigation, diagnosis, and fix phases with explicit success criteria, ensuring targeted fixes are verified.