debug

Diagnoses root causes of code modifications using a seven-step debugging workflow and generates verified fix plans.

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/iciakky/cc-general-skills --skill debug-iciakky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/iciakky/cc-general-skills/tree/main/skills/debug
Command: npx skills add https://github.com/iciakky/cc-general-skills --skill debug-iciakky

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Debugging is often a chaotic, time-consuming, and frustrating process that relies on guesswork. This Skill brings a structured, scientific methodology to bug resolution, eliminating frustration and ensuring root causes are identified, not just symptoms. It's especially useful when AI-modified code introduces anomalies or users report unexpected failures.

Core Features & Use Cases

  • 7-Step Medical Diagnosis Approach: Follows a rigorous workflow from observation to prevention, ensuring no stone is left unturned in your investigation.
  • Evidence-Based Investigation: Prioritizes facts over assumptions, building a "differential diagnosis list" of potential failure points before systematic elimination.
  • Comprehensive Documentation: Generates investigation logs and post-mortem reports, making your debugging process transparent, reproducible, and a source of future learning.
  • Use Case: When a recent code change causes an unexpected error in your application, activate this skill to systematically diagnose the issue, identify the root cause, and implement a robust fix, complete with a prevention mechanism to avoid recurrence.

Quick Start

"I've encountered an unexpected error after deploying my latest code changes. Activate the debug skill to help me diagnose the problem systematically."

Frequently Asked Questions about debug

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

FAQPage Schema
How do I systematically diagnose a bug after code changes?

Systematic debugging follows a seven-step workflow: observe the failure, classify and isolate facts, build a differential diagnosis list, deduce and exclude possibilities, verify experimentally, locate and implement the fix, and establish prevention mechanisms. This evidence-based approach eliminates guesswork and identifies root causes, not just symptoms.

What should I do when AI-modified code introduces unexpected errors?

Activate a structured debugging process that gathers logs, diffs, and configuration data to diagnose post-change anomalies. The workflow produces a root-cause diagnosis, a verified fix plan, and preventive changes to avoid recurrence.

Can I use debugging to troubleshoot unexpected test results and execution faults?

Yes. Debugging covers unexpected test results, execution faults, and behavior divergences. It applies evidence-based investigation to isolate failure points and systematically exclude possibilities until the root cause emerges.

How do logs and diffs help identify the root cause of a bug?

Logs, diffs, and configurations serve as evidence in systematic diagnosis. They reveal what changed, when the failure occurred, and how behavior diverged, enabling you to build a differential diagnosis list and exclude possibilities methodically.

What's the difference between fixing a symptom and diagnosing a root cause?

Symptom fixes address surface behavior; root-cause diagnosis identifies why the failure occurred and prevents recurrence. The seven-step medical approach ensures you locate the underlying issue and implement preventive changes, not temporary workarounds.

Why document the debugging process?

Comprehensive investigation logs and post-mortem reports make your debugging transparent and reproducible. Documentation creates a learning resource for future anomalies and provides evidence for compliance and knowledge sharing across teams.