obra avatar

Requesting Code Review

This dispatches a code reviewer subagent that gets clean context about your changes without your session history, keeping reviews focused on the actual work product. It's built for subagent-driven development where you review after each task, but works for any feature or bug fix. The reviewer gets git SHAs, requirements, and a description of what you implemented, then returns categorized feedback (Critical, Important, Minor). The templated approach means you can quickly get fresh eyes on code without context pollution. Works best when you actually fix the Critical and Important issues before proceeding rather than collecting feedback you'll ignore.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
26
skills.sh installs
276.5K
GitHub stars
315.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add obra/superpowers --skill requesting-code-review --agent claude-code

Installs into .claude/skills of the current project.

Files

Requesting Code Review

Dispatch a code reviewer subagent to catch issues before they cascade. The reviewer gets precisely crafted context for evaluation — never your session's history.

Core principle: Review early, review often.

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: git merge-base origin/main HEAD
HEAD_SHA=$(git rev-parse HEAD)

2. Dispatch code reviewer subagent:

Dispatch a general-purpose subagent, filling the template at code-reviewer.md

Placeholders:

  • {DESCRIPTION} - Brief summary of what you built
  • {PLAN_OR_REQUIREMENTS} - What it should do
  • {BASE_SHA} - Starting commit
  • {HEAD_SHA} - Ending commit

3. Act on feedback:

  • Fix Critical issues immediately
  • Fix Important issues before proceeding
  • Note Minor issues for later
  • Push back if reviewer is wrong (with reasoning)

Example

Sponsors

Details

Repository
github.com/obra/superpowers
Categories
Git & Pull Requests, Code Review & Quality

More from obra/superpowers

All 14
1dietrichgebert avatarponytail-reviewdietrichgebert/ponytailCode review focused exclusively on over-engineering. Finds what to delete: reinvented standard library, unneeded dependencies, speculative abstractions, dead fl67.7Kskills.sh installs
2github avatargh-stackgithub/gh-stackManages stacked PRs and splits multi-part work into reviewable branches with gh-stack. Use for stack creation, viewing, edits, push, submit, sync, rebase, merge20.8Kskills.sh installs
3wshobson avatargit-advanced-workflowswshobson/agentsMaster advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use wh19.9Kskills.sh installs
4coderabbitai avatarcode-reviewcoderabbitai/skillsAI-powered code review using CodeRabbit. Default code-review skill. Trigger for any explicit review request AND autonomously when the agent thinks a review is n16Kskills.sh installs
5rohitg00 avatarcommit-contextrohitg00/agentmemoryTrace a file, function, or line back to the agent session that produced its current commit. Use when the user asks "why is this code here", "what was the agent 14.3Kskills.sh installs
6github avatarmake-repo-contributiongithub/awesome-copilotAll changes to code must follow the guidance documented in the repository. Before any issue is filed, branch is made, commits generated, or pull request (or PR)11.1Kskills.sh installs