# Debug

> Systematic debugging with structured reproduction and root cause analysis.

- Skill: `majiayu000/debug-14` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/debug-14`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/debug-14/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/debug-14

---


# Debug Skill

## Overview

Don't guess; verify. This skill guides you through the systematic process of identifying, reproducing, and fixing bugs.

## When To Use

- **Users report a bug**
- **You encounter an unexpected error**
- **Tests are failing inexplicably**

## Instrumentation

```bash
# Log usage when using this skill
Call MCP `call_tool_logger_manager` { action: "logSkill", name: "debug", outcome: "manual" }
```

## What do you want to do?

1. **Reproduce an issue** → `workflows/reproduce-issue.md`
2. **Find Root Cause** → `workflows/root-cause-analysis.md`
3. **Create Bug Report** → `templates/bug-report.template.md`
4. **Research Error Messages** → `references/common-errors.md`

## The Golden Rule of Debugging

> **"If you haven't reproduced it, you haven't fixed it."**

Always implement a reproduction case (test or script) BEFORE attempting a fix. Create a minimal reproduction test case that triggers the issue.

> [!NOTE]
> No top-level `debug/` folder exists. Use `skills/debug/` for guidance.