review-fix
Installation
SKILL.md
Review 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.