SKILL.md
Requesting Code Review
Prepare a complete review request so the reviewer can evaluate the exact change against the intended requirements.
Core principle: Review early, review often.
Routing Boundary
Use this skill when the user needs to prepare or request a code review.
This skill owns the request package: implementation summary, requirements reference, base/head git range, reviewer prompt, and response handling checklist.
Use code-reviewer for the actual review findings.
Use receiving-code-review when review feedback already exists and must be evaluated or applied.
When to Request Review
Mandatory:
- After each task in subagent-driven development
- After completing major feature
- Before merge to main
Optional but valuable:
- When stuck (fresh perspective)
- Before refactoring (baseline check)
- After fixing complex bug
How to Request
1. Get git SHAs:
BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
HEAD_SHA=$(git rev-parse HEAD)
2. Dispatch code-reviewer subagent:
Use Task tool with superpowers:code-reviewer type, fill template at code-reviewer.md
Placeholders:
{WHAT_WAS_IMPLEMENTED}- What you just built{PLAN_OR_REQUIREMENTS}- What it should do{BASE_SHA}- Starting commit{HEAD_SHA}- Ending commit{DESCRIPTION}- Brief summary
3. Act on feedback:
- Fix Critical issues immediately
- Fix Important issues before proceeding
