Skip to main content
skill CX Codex

fix-issue · frappe — Claude Code skill: fix bugs from GitHub issues

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.

no license 431 installs ★ 177 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add frappe/skills --skill fix-issue -a claude-code
Open on GitHub

What fix-issue 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.

What it helps with

  • 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 for the agent

  • 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

How to install fix-issue

1Skills CLI (Vercel)

npx skills add frappe/skills --skill fix-issue -a claude-code

2Manually: put the files in place

~/.claude/skills/fix-issue/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fix-issue/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fix-issue

How to install fix-issue in Claude Code?

Run npx skills add frappe/skills --skill fix-issue -a claude-code. The skill lands at ~/.claude/skills/fix-issue/SKILL.md.

What does fix-issue do?

It sends a subagent to pull facts out of a bug report, then reproduces the bug, traces the cause, applies a minimal fix with a regression test and passes the diff to a reviewer agent.

Why doesn't the main agent read the issue itself?

Guesses in the report steer the search and make the symptom look like the cause. The extractor keeps only what can be observed, and the main agent builds its own theory from the code.

Similar skills

All skills for Agent setup: memory, context, orchestration →

fix-issue by other authors comes first.

fix-issue OrchestKit The fix-issue skill investigates a GitHub issue, applies a tested fix, opens a linked PR, and records ways to prevent the bug from returning. CX Codex +1 217installs fix-issue justxor fix-issue — a skill that runs the full cycle of fixing a GitHub issue by number — from analysis and test to commit. CX Codex +1 ★ 353repo stars issue-tracer2 ZaxbyHub issue-tracer2 pulls in a GitHub Issue, works through a chain of hypotheses to pin down the root cause, and carries the fix through to tests and a PR. CX Codex +1 ★ 539repo stars om-auto-fix-issue open-mercato The om-auto-fix-issue Claude Code skill takes a tracker issue through a bug-fix or feature workflow. Give it an issue reference or a plain description of the problem. CX Codex +1 4,700installs github-issue-fix safayavatsal The github-issue-fix plugin lets Claude Code analyze GitHub issues and work on resolving them. Use it to hand an issue’s task to the agent. ★ 1,013repo stars codex-issue-coordinator owainlewis codex-issue-coordinator is a Codex skill that assigns GitHub issues to AI workers, tracks PRs and tests, and merges completed work. It handles batches in one Codex conversation. CX Codex +1 241installs om-fix-issue open-mercato om-fix-issue — a skill for Claude Code and Codex that diagnoses a tracker issue, verifies a regression test, and leaves staged changes for manual review without committing or opening a PR. CX Codex +1 502installs fix-github-issue davila7 The fix-github-issue command takes a GitHub issue number, investigates the related code, and works through a fix with tests. Use it to carry an issue from its report to a commit. CX Codex +1 386installs

From the same set10

The whole set →
ui-design ui-design — a skill that gives the agent design rules for layout, type, color and spacing. Useful when no product design-system skill exists. CX Codex +1 1,100installs code-style code-style is a Claude Code skill for setting code-style rules. It loads during code edits and when requests concern refactoring, function or file size, structure, or comments. CX Codex +1 1,100installs technical-writing technical-writing — a skill that makes the agent write in Simplified Technical English: short sentences, active voice, one word per meaning. Meant for docs, READMEs and commits. CX Codex +1 766installs draft-security-advisory draft-security-advisory transforms vulnerability reports into publication-ready GitHub Security Advisories without leaking payloads, endpoints, or file paths. CX Codex +1 724installs resolve-backport-conflicts resolve-backport-conflicts resolves merge conflicts in Mergify backport pull requests. It cleans up conflict markers and discards unrelated changes after cherry-pick failures. CX Codex +1 680installs frappe-code-review frappe-code-review is a Claude Code skill that reviews Frappe apps by checklist, from correctness and stability to security and performance. Apply it to a diff, pull request or single file. CX Codex +1 546installs deep-app-audit deep-app-audit is a Claude Code skill for auditing Frappe apps for security issues, logic errors, and customization defects. Parallel agents check separate code aspects in fresh contexts and compile one report. CX Codex +1 458installs ship-it This Claude Code skill takes finished changes through review and PR preparation. Run /ship-it to start, or resume work on a branch that already has an open PR. CX Codex +1 328installs

Project sponsors

Companies that keep this analytics open