Skill353 repo starsupdated 3mo ago

debug

The debug skill provides a structured methodology for identifying and resolving software bugs through systematic reproduction and root cause analysis. Use it when users report bugs, unexpected errors occur, or tests fail without clear explanation. The skill guides users through reproducing issues, analyzing root causes, creating bug reports, and researching error messages, emphasizing that bugs must be reproduced before fixes are implemented.

View source Repository: gemini-kit

Install in Claude Code

Copy

git clone --depth 1 https://github.com/nth5693/gemini-kit /tmp/debug && cp -r /tmp/debug/skills/debug ~/.claude/skills/debug

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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
./scripts/log-skill.sh "debug" "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. Highly recommended to use the template at `docs/templates/repro-script-template.sh` and store artifacts in `scripts/repro/`.

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