# Debug

Reproduce, minimize, localize, identify root cause, and distinguish diagnosis from an...

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill debug -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill debug -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill debug -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill debug -g -a gemini-cli -y`

## Description

Reproduce, minimize, localize, identify root cause, and distinguish diagnosis from an authorized fix. Prefer root-cause over symptom patches.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Debug

## When to use
Use for failures, flakes, wrong outputs, crashes, and regressions.

## Non-goals
- Do not jump to a fix before reproduction/localization when the bug is unclear.
- Do not treat “run all tests” as debugging by default.

## Workflow
1. Reproduce or gather the strongest available failure signal.
2. Minimize the case.
3. Localize to component/file/line.
4. State root cause vs symptoms.
5. Fix only when authorized; otherwise hand back a diagnosis with evidence.

## Output shape
- Symptom
- Reproduction
- Localization
- Root cause
- Fix status / next step