# Bug Fixing

> Group skill: Systematic bug fixing — diagnose, error analysis, trace logs, performance profiling, targeted fix, regression test, code review, and postmortem.

- Skill: `may215/bug-fixing` (Agent Skill)
- Install (CLI): `npx skillmds@latest add may215/bug-fixing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/may215/bug-fixing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: may215 (https://skillmd.com/u/may215)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/may215/bug-fixing

---


# 🐛 Bug Fixing / Debugging

> **Group Skill** — Orchestrates sub-skills for finding and fixing bugs systematically.
> Activate by saying: "Fix this bug" or "debug this issue"

## When to Use

- Something is broken in production or dev
- Need to find and fix root cause
- Prevent regressions

## Step-by-Step Workflow

### Step 1: Diagnose
**Skill**: `systematic-debugging`
- Methodical root cause analysis
- Eliminate hypotheses systematically
- Document findings

### Step 2: Error Analysis
**Skill**: `error-diagnostics-smart-debug`
- Smart error pattern matching
- Classify error type
- Identify affected components

### Step 3: Trace Logs
**Skill**: `distributed-tracing`
- Follow request flow across services
- Check error propagation
- Verify data flow

### Step 4: Performance
**Skill**: `performance-profiling`
- Find slow code paths
- Check memory usage
- Identify bottlenecks

### Step 5: Fix
**Skill**: `debugger` + `debugging-toolkit-smart-debug`
- Apply targeted fix
- Minimize scope of change
- Verify no side effects

### Step 6: Regression Test
**Skill**: `tdd-workflow`
- Write test that reproduces bug
- Ensure test fails without fix
- Verify test passes with fix

### Step 7: Code Review
**Skill**: `code-reviewer`
- Verify fix quality
- Check for edge cases
- Review related code

### Step 8: Postmortem
**Skill**: `incident-response-incident-response`
- Document what happened
- Identify root cause
- Define prevention measures

## Completion

Bug is fixed, tested, reviewed, and documented. 🐛

## Sub-Skills Referenced

1. `systematic-debugging`
2. `error-diagnostics-smart-debug`
3. `distributed-tracing`
4. `performance-profiling`
5. `debugger`
6. `tdd-workflow`
7. `code-reviewer`
8. `incident-response-incident-response`