# Fix Issue

> Analyze and fix a GitHub issue end-to-end

- Skill: `smartwhale8/fix-issue` (Agent Skill)
- Install (CLI): `npx skillmds@latest add smartwhale8/fix-issue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/smartwhale8/fix-issue/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: smartwhale8 (https://skillmd.com/u/smartwhale8)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/smartwhale8/fix-issue

---


Analyze and fix the GitHub issue: $ARGUMENTS

Follow this workflow:

1. **Understand**: Run `gh issue view $ARGUMENTS` to get issue details
2. **Investigate**: Search the codebase for relevant files and understand the root cause
3. **Plan**: Describe your approach before making changes
4. **Implement**: Make the necessary code changes
5. **Test**: Write a test that would have caught this issue, then run the test suite
6. **Verify**: Ensure lint and type checks pass
7. **Commit**: Create a descriptive commit message referencing the issue
8. **PR**: Push and create a PR with `gh pr create`

Important:
- Address the ROOT CAUSE, not just the symptom
- If the fix requires changes across multiple files, explain why
- If the issue is unclear, ask for clarification before implementing