Skill146 repo starsupdated 29d ago

bug-fix

bug-fix orchestrates a structured debugging workflow that prioritizes regression prevention by writing a failing test first, then implementing a minimal fix, verifying all tests pass, and optionally running browser QA for UI bugs. Use this skill when addressing reported bugs to ensure fixes are isolated, tested, and don't break existing functionality.

View source Repository: claude-code-agents

Install in Claude Code

Copy

git clone --depth 1 https://github.com/undeadlist/claude-code-agents /tmp/bug-fix && cp -r /tmp/bug-fix/skills/bug-fix ~/.claude/skills/bug-fix

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

Definition

SKILL.md

# Bug Fix Workflow

Fix bugs with a test-first approach to prevent regressions. Provide the bug description when invoking.

## Execution (Sequential)

### Step 1: Reproduce with Test
Spawn `test-writer` with the bug description:
- Create a test that fails (reproduces the bug)
- Test should pass after the fix is applied

### Step 2: Fix the Bug
Spawn `code-fixer` with the bug description and test file:
- Find root cause
- Implement minimal fix
- Don't refactor unrelated code

### Step 3: Verify
Spawn `test-runner`:
- New test passes (bug is fixed)
- All existing tests pass (no regressions)

### Step 4: Browser QA (if UI bug)
Spawn `browser-qa-agent`:
- Reproduce original steps
- Confirm bug is fixed
- Check related features still work

## Usage

Provide bug details when invoking:
```
/bug-fix

Bug: Login fails with valid credentials
Steps to reproduce:
1. Go to /login
2. Enter valid email/password
3. Click submit
Expected: Redirect to dashboard
Actual: 500 error
Location: src/api/auth/login.ts
```

## Skip browser-qa for
- Non-UI bugs (API, background jobs)
- Build/compilation issues
- Test infrastructure bugs