About review-fix
A skill for running a review, fix, and verification cycle while preserving review independence and limiting changes to the requested scope. It directs agents to classify findings, apply suitable fixes, and verify each change.
Key features
- 01Review finding classification
- 02Scope-limited issue fixes
- 03Red-green testing when applicable
- 04Targeted checks after fixes
- 05Final diff and result reporting
Use cases
- 01Addressing findings from code review
- 02Verifying a narrowly scoped code change
- 03Reporting blocked or unresolved review items
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ gil-1/ skills --skill review-fixAfter installing, type/review-fixin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMEReview Fix
Run a review → fix → verify loop. Preserve review independence and stay within the requested change.
1. Review
- Establish the review target, fixed point, source issue or spec when one exists, and relevant repo instructions.
- Load
code-reviewand follow it. Tell it that documentation added or strengthened by the diff is implementation under review and cannot expand the source issue or spec; when it promises more than required, recommend narrowing the documentation. Let its fresh Standards and Spec reviewers report before editing. - Classify every finding as
fix,not-actionable,out-of-scope, orblocked. Treat judgment-call smells as actionable only when the evidence supports changing them, and do not broaden implementation solely to satisfy documentation added or strengthened by the diff.
Continue when every finding has a disposition.
2. Fix
Fix each actionable finding within the reviewed scope:
- For behavior that can be covered at an agreed test seam, load
tddand use a red → green cycle. - Apply clear documentation, configuration, naming, and refactoring fixes directly.
- Load
diagnosing-bugswhen the cause is unclear, the failure is difficult to reproduce, flaky, or performance-related, or a first fix fails.
Run the smallest relevant check after each fix. Continue when every actionable finding is verified or blocked with evidence.
3. Verify
- Run the review target's relevant checks.
- Inspect the final diff against the findings. Rerun
code-reviewwhen fixes materially changed the design or scope. - Commit only when assigned commit ownership.
- Return
passed,fixed, orblocked, with finding dispositions, changed files, checks, commits when applicable, and remaining blockers.
Finish only when every finding is accounted for and every fix has verification evidence.