review-issue
Installation
SKILL.md
Review Issue
Review and repair exactly one GitHub issue implementation in the current checkout. Stay local: do not create worktrees, Docker containers, branches, pull requests, labels, issue comments, pushes, or issue closes.
Intake
- Require exactly one GitHub issue number from the user. If it is missing or ambiguous, ask for the issue number and stop.
- Read repository instructions before editing: root
AGENTS.md, nestedAGENTS.mdfiles that apply to touched paths, and any domain or issue-tracker docs those files name. - Fetch the issue packet with
gh issue view <number> --comments. - Search the issue body and comments for parent PRD references, blocker issues, follow-on issues, and related implementation issues. Fetch every linked issue that affects expected behavior with
gh issue view <number> --comments. - Treat the issue packet, linked PRD/spec, existing tests, and repo instructions as the source of truth. Do not pause for plan approval unless they contradict each other or required context is missing.
- Work on the current branch only. Do not create or switch branches.
- Infer the base branch from a user-provided base, the branch upstream, or the repository default branch. Confirm it resolves before reviewing.
- Run
git status --short,git log --oneline <base>..HEAD, andgit diff <base>...HEAD. If the implementation diff is empty, stop withBLOCKED: no implementation diff to review.
Intake is complete when the issue packet, linked context, repo instructions, base branch, working-tree state, commit list, and implementation diff are understood.