What problem does it solve?
This Skill provides a systematic, intelligence-first approach to debugging. It traces from a reported symptom to the root cause, parses error messages, leverages code intelligence, and proposes validated fixes, significantly reducing debugging time and effort.
Core Features & Use Cases
- Systematic Root Cause Analysis: Captures symptoms, parses error messages (type, file:line, stack trace), and uses
project-intel.mjs to trace dependencies and identify the exact source of the bug.
- CoD^Σ Trace & MCP Verification: Documents a complete Chain-of-Thought (CoD^Σ) reasoning chain and verifies findings against authoritative sources (MCP) for transparent, evidence-backed diagnoses.
- Comprehensive Bug Report: Generates a detailed
bug-report.md including symptom, root cause, fix specification (with code changes), and a verification plan, ready for implementation.
- Use Case: If a user reports a "TypeError: Cannot read property 'discount' of undefined" during checkout, this Skill will pinpoint the missing null check at
src/pricing/calculator.ts:67, explain why it fails, and provide the exact code fix with a test plan.
Quick Start
Use the debug-issues skill to diagnose the 'TypeError' in the attached error log.