# fix-issue

fix-issue turns a bug report into a fix: a subagent extracts the facts, the main agent reproduces the bug and traces the cause without inheriting the reporter's guesses.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 431 installs · ★ 177 repo stars
- Author: frappe
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/frappe/skills/tree/HEAD/skills/fix-issue/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/frappe-fix-issue

## What it does

The skill takes an issue number, a link to the issue, or a path to a markdown file. A `general-purpose` subagent reads the report and returns a factual brief: symptom, expected result, reproduction steps, error text, environment, scope. Proposed patches, hunches about the cause and comments like "the bug is in x.py" never reach the main context. The main agent does not open the report itself, not even to check one detail later; it asks the same extractor through `SendMessage`.

Reproduction comes before any edit. Three results end the run early: the bug does not reproduce and the brief lists gaps, it does not reproduce while the brief is complete, or it reproduces but the behaviour is correct. When the bug is confirmed, the cause gets traced through the code and the fix stays minimal, with a regression test that fails without it, the surrounding test module and `pre-commit run --files <changed files>`.

Reading a GitHub issue needs `gh` on the machine, because the extractor calls `gh issue view <n> --comments`. The diff goes to a second agent that loads the `frappe-code-review` skill, so that skill is required for the review step.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill fix-issue -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill fix-issue -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill fix-issue -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install frappe/skills skills/fix-issue
```

2. **Manually: put the files in place**
- File: `.github/skills/fix-issue/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill fix-issue -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/frappe/skills --path skills/fix-issue
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill fix-issue -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/frappe/skills/tree/HEAD/skills/fix-issue/SKILL.md

## When to use it
- turn a noisy GitHub issue into a factual brief
- reproduce a reported bug before touching code
- trace the defect through the code, not through the reporter's hints
- add a regression test that fails without the fix
- hand the working diff to a second agent for review

## Example prompts
- Use the fix-issue skill on issue 4210 and fix the bug
- Reproduce the bug in `docs/bugs/login.md` and trace the cause
- Fix the reported issue, then have a separate agent review the diff

## Similar
- [issue-tracer2](https://affpapa.org/en/nevibecode/agents/issue-tracer2.md) — subagent · ★ 539 repo stars
- [om-auto-fix-issue](https://affpapa.org/en/nevibecode/skills/om-auto-fix-issue.md) — skill · 4700 installs
- [github-issue-fix](https://affpapa.org/en/nevibecode/plugins/github-issue-fix.md) — plugin · ★ 1013 repo stars
- [codex-issue-coordinator](https://affpapa.org/en/nevibecode/skills/codex-issue-coordinator.md) — skill · 241 installs
- [om-fix-issue](https://affpapa.org/en/nevibecode/skills/om-fix-issue.md) — skill · 502 installs
- [fix-github-issue](https://affpapa.org/en/nevibecode/commands/fix-github-issue.md) — command · 386 installs

## Other versions with the same name
- [fix-issue · yonatangross](https://affpapa.org/en/nevibecode/skills/orchestkit-fix-issue.md) — 217 installs
- [fix-issue · justxor](https://affpapa.org/en/nevibecode/skills/fix-issue.md) — ★ 353 repo stars

From the same set: [frappe/skills](https://affpapa.org/en/nevibecode/by/frappe/skills.md) — 10 cards

---
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
