# Fix Issue

> Fetch a GitHub issue, implement the fix, verify acceptance criteria and quality gates pass, then open a pull request. Use when the user types /fix-issue <number> or says "fix issue

- Skill: `rockclaver/fix-issue` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rockclaver/fix-issue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rockclaver/fix-issue/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rockclaver (https://skillmd.com/u/rockclaver)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rockclaver/fix-issue

---


# fix-issue

### 1. Fetch issue
```bash
gh issue view <number> --json title,body,labels,assignees,comments
```
Extract `- [ ]` criteria; derive from description if absent.

### 2. Branch
```bash
git checkout -b fix/issue-<number>-<slug>   # kebab-case, 5 words max
```
Never commit to main.

### 3. Implement
Scope to the issue only. Commit referencing `#<number>`.

### 4. Quality gates
```bash
npx tsc --noEmit && npm run lint && npm test
```
Fix failures first, then verify each `- [ ]` criterion. **Never open the PR on a failing gate.**

### 5. Open the PR
```bash
gh pr create \
  --title "<issue title>" \
  --body "$(cat <<'EOF'
## Summary
<bullet list of changes>

## Closes
Closes #<number>

## Acceptance criteria
<criteria list, ✅ per completed item>

## Test plan
<how to verify>

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
```

## Edge cases
Not found → error, stop. No tests → note, flag in PR. Ambiguous → ask first.

See [REFERENCE.md](REFERENCE.md) for language-specific quality gate commands.