debug

Enforces root-cause-first debugging across multi-component systems with four required phases.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/CasaPerks/casaflow --skill debug-casaperks
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/CasaPerks/casaflow/tree/main/core/skills/debug
Command: npx skills add https://github.com/CasaPerks/casaflow --skill debug-casaperks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents guess-and-check debugging by forcing a disciplined root-cause investigation before any implementation changes.

Core Features & Use Cases

  • Root-cause-first debugging: Guides you through investigation, pattern analysis, hypothesis testing, and only then implementation.
  • Evidence gathering in multi-component systems: Prompts you to instrument boundaries (CI→build→signing, API→service→DB, etc.) so you can pinpoint where failures occur.
  • Controlled change discipline: Requires a failing test case, a single fix, and verification before claiming the issue is resolved.
  • Use Case: When a CI build fails after a dependency or config change, this Skill helps you reproduce the failure, identify the failing component, test a minimal hypothesis, then validate the fix with tests and verification.

Quick Start

Use the debug skill for this task: Investigate the failing test, identify the root cause using the four phases, then propose a single-root-cause fix with a failing test and a verification plan.

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 test failure before changing code?ā–¼

To find the root cause of a test failure, complete root cause investigation, pattern analysis, hypothesis testing, and implementation with failing tests. This disciplined approach prevents guess-and-check fixes that cause regressions.

What is the best way to debug CI build failures after a dependency change?ā–¼

The best way to debug CI build failures is to reproduce the failure, instrument boundaries across multi-component systems to pinpoint the failing component, test a minimal hypothesis, and validate the fix with failing tests and a verification plan.

How do I stop guess-and-check debugging for production bugs?ā–¼

Stop guess-and-check debugging by enforcing a root-cause-first approach that requires evidence gathering and pattern analysis before implementation. You must identify the exact failure point before proposing any fixes to avoid thrashing.

Can I use root cause analysis for integration problems across multi-component systems?ā–¼

Yes, root cause analysis applies to integration problems across multi-component systems. You instrument boundaries such as API to service to database to pinpoint where failures occur before testing a minimal hypothesis and implementing a single fix.

Why does my debugging process cause regressions and thrashing?ā–¼

Debugging causes regressions and thrashing when you apply symptom-focused fixes without identifying the root cause first. Enforcing investigation, pattern analysis, and hypothesis testing with minimal changes before implementation prevents these regressions.