# bug-fixing

The bug-fixing skill guides focused bug fixes and their verification in any programming language. Use it after the cause of a problem has been investigated.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install
- Author: kishan04rajput
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kishan04rajput/ai-ide-rules/tree/HEAD/skills/skill-bug-fixing/SKILL.md
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bug-fixing

## What it does

\`bug-fixing` gives an agent a workflow for implementing a fix after the defect has been examined. It compares possible approaches, checks whether the choice fits the language and existing architecture, then keeps the code change as small as practical. The workflow also asks the agent to address the underlying cause instead of hiding the visible symptom.

Verification covers the original reproduction path, existing tests, related modules, and boundary conditions found during analysis. Those checks can include null handling, concurrent execution, and memory limits. The skill is for implementation and validation, so bug discovery and diagnosis belong to `identify-bugs` first.

It can be installed for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, or OpenCode. When checks pass, the agent reports a clean result; when they do not, it lists possible risks and side effects.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add kishan04rajput/ai-ide-rules --skill bug-fixing -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-bug-fixing/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-bug-fixing/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add kishan04rajput/ai-ide-rules --skill bug-fixing -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-bug-fixing/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add kishan04rajput/ai-ide-rules --skill bug-fixing -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-bug-fixing/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kishan04rajput/ai-ide-rules skills/skill-bug-fixing
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-bug-fixing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add kishan04rajput/ai-ide-rules --skill bug-fixing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/kishan04rajput/ai-ide-rules --path skills/skill-bug-fixing
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-bug-fixing/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add kishan04rajput/ai-ide-rules --skill bug-fixing -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/kishan04rajput/ai-ide-rules/tree/HEAD/skills/skill-bug-fixing/SKILL.md

## When to use it
- implement a fix for an already diagnosed bug
- compare two ways to resolve the same defect
- keep a patch aligned with the project’s language patterns
- check related modules for regressions
- test edge cases revealed during diagnosis

## Example prompts
- Fix the diagnosed issue in `src/auth.ts` with the smallest suitable code change, then rerun its reproduction steps.
- Compare two possible patches, choose the one that matches this codebase, and run the related tests.
- Validate the fix with null values and concurrent execution, then report any possible side effects.

## Similar
- [bug-fix](https://affpapa.org/en/nevibecode/skills/bobmatnyc-bug-fix.md) — skill · 488 installs
- [bug-detective](https://affpapa.org/en/nevibecode/skills/bug-detective.md) — skill · 412 installs
- [bug-receipt](https://affpapa.org/en/nevibecode/skills/bug-receipt.md) — skill · 43 installs
- [bug-reproduction](https://affpapa.org/en/nevibecode/skills/bug-reproduction.md) — skill · 1800 installs
- [bug-reproduction-brief](https://affpapa.org/en/nevibecode/skills/bug-reproduction-brief.md) — skill · 62 installs
- [implement](https://affpapa.org/en/nevibecode/skills/boshu2-implement.md) — skill · 1500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
