What problem does it solve?
This Skill automates systematic code review workflows to surface bugs, security risks, performance issues, missing tests, and documentation drift while keeping large diffs out of the main context for token efficiency.
Core Features & Use Cases
- Scope detection: Extracts PR numbers, branch context, staged/unstaged changes, or explicit file lists to determine what to review.
- Plan alignment: Looks up associated plan files (F-XXXX patterns) and compares implementation against stated deliverables when available.
- Subagent orchestration: Spawns a fresh-context subagent to run diffs and file reads, preserving the main context and enforcing a structured checklist-driven review protocol.
- Structured output: Requires the subagent to return a standardized findings report (Review Summary, Must Fix, Should Fix, Consider, Verdict) for direct presentation to users.
- Use case: Run on a pull request to get a prioritized, checklist-based report highlighting security, correctness, tests, and required documentation updates.
Quick Start
Ask the agent to "/review PR #42" or "review current changes" and it will detect scope, check for a plan file, spawn a subagent to run the appropriate git/gh diff commands, and present the subagent's structured findings.