debug

Diagnose and fix codebase bugs through structured root-cause analysis.

Updated Jan 11, 2026
One-click install
npx skills add https://github.com/AdemKao/ai-cowork --skill debug-ademkao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/AdemKao/ai-cowork/tree/main/.ai/skills/debug
Command: npx skills add https://github.com/AdemKao/ai-cowork --skill debug-ademkao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically diagnose and fix bugs across codebases by guiding you through reproducibility, information gathering, and root-cause analysis.

Core Features & Use Cases

  • Reproduce issues with precise steps and capture inputs, outputs, and environment.
  • Gather evidence from logs, diffs, and tests to form hypotheses.
  • Iterate with a structured fix-and-verify loop to prevent regressions.

Quick Start

Describe the issue, reproduce it with precise steps, and propose a minimal, testable 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 in my code?

To find the root cause of a bug, you need to reproduce it precisely, gather evidence from logs and tests, form hypotheses, and isolate variables. This structured approach guides you stepwise through reproduction, information gathering, and root-cause analysis to fix issues reliably.

What's the best way to debug failing tests and unexpected runtime behaviors?

Debugging failing tests and unexpected runtime behaviors requires gathering inputs, outputs, and environment details to reproduce the issue. You then iterate through a structured fix-and-verify loop, applying minimal reproduction and test coverage to prevent future regressions.

How do I create a minimal reproduction for a bug?

Creating a minimal reproduction involves capturing precise steps, inputs, and environment conditions that trigger the bug consistently. By isolating variables and forming hypotheses from gathered evidence, you can narrow down the exact trigger and propose a minimal, testable fix.

How does logging help with root-cause analysis when diagnosing bugs?

Logging provides the evidence needed for root-cause analysis by capturing runtime behavior, inputs, and errors. By gathering information from logs and diffs, you can form accurate hypotheses about why a bug occurs and verify your fix effectively.

Can I use this debugging approach across different programming languages and projects?

Yes, this debugging approach applies to failing tests and unexpected runtime behaviors across languages and projects. It implements a language-agnostic, stepwise methodology including reproduction, information gathering, hypothesis formation, isolation, and verification.

How do I prevent regressions when fixing bugs in a codebase?

Preventing regressions when fixing bugs requires iterating with a structured fix-and-verify loop. By using minimal reproduction and adding test coverage after isolating the root cause, you ensure the original issue is resolved without introducing new defects.