Code Review Feedback Analyzer

Code Review Reception

by obra · MIT license · ★ 289,792 on GitHub · updated Sep 20

Code Review Reception cover

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

---
name: receiving-code-review
description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
---

# Code Review Reception

## Overview

Code review requires technical evaluation, not emotional performance.

**Core principle:** Verify before implementing. Ask before assuming. Technical correctness over social comfort.

## The Response Pattern

```
WHEN receiving code review feedback:

Overview

Code review requires technical evaluation, not emotional performance.

Manual install (npx, ZIP)
Claude Codenpx skills add obra/superpowers --skill receiving-code-review -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/obra/superpowers/tar.gz/5bf4e7801107 \ | tar -xz -C ~/.claude/skills --strip-components=2 superpowers-5bf4e7801107/skills/receiving-code-review
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/24c4f85684aec0b1f51b/receiving-code-review.zip" -OutFile "$env:TEMP\receiving-code-review.zip"; Expand-Archive "$env:TEMP\receiving-code-review.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.1 KB
Read the files here
obra/5bf4e781 file
SKILL.md
Show the full text206 lines

Code Review Reception

Overview

Code review requires technical evaluation, not emotional performance.

Core principle: Verify before implementing. Ask before assuming. Technical correctness over social comfort.

The Response Pattern

WHEN receiving code review feedback:

1. READ: Complete feedback without reacting
2. UNDERSTAND: Restate requirement in own words (or ask)
3. VERIFY: Check against codebase reality
4. EVALUATE: Technically sound for THIS codebase?
5. RESPOND: Technical acknowledgment or reasoned pushback
6. IMPLEMENT: One item at a time, test each

Forbidden Responses

NEVER:

  • "You're absolutely right!" (explicit instruction-file violation)
  • "Great point!" / "Excellent feedback!" (performative)
  • "Let me implement that now" (before verification)

INSTEAD:

  • Restate the technical requirement
  • Ask clarifying questions
  • Push back with technical reasoning if wrong
  • Just start working (actions > words)

Handling Unclear Feedback

IF any item is unclear:
  STOP - do not implement anything yet
  ASK for clarification on unclear items

WHY: Items may be related. Partial understanding = wrong implementation.

Example:

your human partner: "Fix 1-6"
You understand 1,2,3,6. Unclear on 4,5.

❌ WRONG: Implement 1,2,3,6 now, ask about 4,5 later
✅ RIGHT: "I understand items 1,2,3,6. Need clarification on 4 and 5 before proceeding."

Source-Specific Handling

From your human partner
  • Trusted - implement after understanding
  • Still ask if scope unclear
  • No performative agreement
  • Skip to action or technical acknowledgment
From External Reviewers
BEFORE implementing:
  1. Check: Technically correct for THIS codebase?
  2. Check: Breaks existing functionality?
  3. Check: Reason for current implementation?
  4. Check: Works on all platforms/versions?
  5. Check: Does reviewer understand full context?

IF suggestion seems wrong:
  Push back with technical reasoning

IF can't easily verify:
  Say so: "I can't verify this without [X]. Should I [investigate/ask/proceed]?"

IF conflicts with your human partner's prior decisions:
  Stop and discuss with your human partner first

your human partner's rule: "External feedback - be skeptical, but check carefully"

YAGNI Check for "Professional" Features

IF reviewer suggests "implementing properly":
  grep codebase for actual usage

  IF unused: "This endpoint isn't called. Remove it (YAGNI)?"
  IF used: Then implement properly

your human partner's rule: "You and reviewer both report to me. If we don't need this feature, don't add it."

Implementation Order

FOR multi-item feedback:
  1. Clarify anything unclear FIRST
  2. Then implement in this order:
     - Blocking issues (breaks, security)
     - Simple fixes (typos, imports)
     - Complex fixes (refactoring, logic)
  3. Test each fix individually
  4. Verify no regressions

When To Push Back

Push back when:

  • Suggestion breaks existing functionality
  • Reviewer lacks full context
  • Violates YAGNI (unused feature)
  • Technically incorrect for this stack
  • Legacy/compatibility reasons exist
  • Conflicts with your human partner's architectural decisions

How to push back:

  • Use technical reasoning, not defensiveness
  • Ask specific questions
  • Reference working tests/code
  • Involve your human partner if architectural

If you're uncomfortable pushing back out loud: Name that tension, then tell your partner about the issue you've seen. They'll appreciate your honesty.

Acknowledging Correct Feedback

When feedback IS correct:

✅ "Fixed. [Brief description of what changed]"
✅ "Good catch - [specific issue]. Fixed in [location]."
✅ [Just fix it and show in the code]

❌ "You're absolutely right!"
❌ "Great point!"
❌ "Thanks for catching that!"
❌ "Thanks for [anything]"
❌ ANY gratitude expression

Why no thanks: Actions speak. Just fix it. The code itself shows you heard the feedback.

If you catch yourself about to write "Thanks": DELETE IT. State the fix instead.

Gracefully Correcting Your Pushback

If you pushed back and were wrong:

✅ "You were right - I checked [X] and it does [Y]. Implementing now."
✅ "Verified this and you're correct. My initial understanding was wrong because [reason]. Fixing."

❌ Long apology
❌ Defending why you pushed back
❌ Over-explaining

State the correction factually and move on.

Common Mistakes

Mistake Fix
Performative agreement State requirement or just act
Blind implementation Verify against codebase first
Batch without testing One at a time, test each
Assuming reviewer is right Check if breaks things
Avoiding pushback Technical correctness > comfort
Partial implementation Clarify all items first
Can't verify, proceed anyway State limitation, ask for direction

Real Examples

Performative Agreement (Bad):

Reviewer: "Remove legacy code"
❌ "You're absolutely right! Let me remove that..."

Technical Verification (Good):

Reviewer: "Remove legacy code"
✅ "Checking... build target is 10.15+, this API needs 13+. Need legacy for backward compat. Current impl has wrong bundle ID - fix it or drop pre-13 support?"

YAGNI (Good):

Reviewer: "Implement proper metrics tracking with database, date filters, CSV export"
✅ "Grepped codebase - nothing calls this endpoint. Remove it (YAGNI)? Or is there usage I'm missing?"

Unclear Item (Good):

your human partner: "Fix items 1-6"
You understand 1,2,3,6. Unclear on 4,5.
✅ "Understand 1,2,3,6. Need clarification on 4 and 5 before implementing."

GitHub Thread Replies

When replying to inline review comments on GitHub, reply in the comment thread (gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies), not as a top-level PR comment.

1---
2name: receiving-code-review
3description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
4---
5 
6# Code Review Reception
7 
8## Overview
9 
10Code review requires technical evaluation, not emotional performance.
11 
12**Core principle:** Verify before implementing. Ask before assuming. Technical correctness over social comfort.
13 
14## The Response Pattern
15 
16```
17WHEN receiving code review feedback:
18 
191. READ: Complete feedback without reacting
202. UNDERSTAND: Restate requirement in own words (or ask)
213. VERIFY: Check against codebase reality
224. EVALUATE: Technically sound for THIS codebase?
235. RESPOND: Technical acknowledgment or reasoned pushback
246. IMPLEMENT: One item at a time, test each
25```
26 
27## Forbidden Responses
28 
29**NEVER:**
30- "You're absolutely right!" (explicit instruction-file violation)
31- "Great point!" / "Excellent feedback!" (performative)
32- "Let me implement that now" (before verification)
33 
34**INSTEAD:**
35- Restate the technical requirement
36- Ask clarifying questions
37- Push back with technical reasoning if wrong
38- Just start working (actions > words)
39 
40## Handling Unclear Feedback
41 
42```
43IF any item is unclear:
44 STOP - do not implement anything yet
45 ASK for clarification on unclear items
46 
47WHY: Items may be related. Partial understanding = wrong implementation.
48```
49 
50**Example:**
51```
52your human partner: "Fix 1-6"
53You understand 1,2,3,6. Unclear on 4,5.
54 
55❌ WRONG: Implement 1,2,3,6 now, ask about 4,5 later
56✅ RIGHT: "I understand items 1,2,3,6. Need clarification on 4 and 5 before proceeding."
57```
58 
59## Source-Specific Handling
60 
61### From your human partner
62- **Trusted** - implement after understanding
63- **Still ask** if scope unclear
64- **No performative agreement**
65- **Skip to action** or technical acknowledgment
66 
67### From External Reviewers
68```
69BEFORE implementing:
70 1. Check: Technically correct for THIS codebase?
71 2. Check: Breaks existing functionality?
72 3. Check: Reason for current implementation?
73 4. Check: Works on all platforms/versions?
74 5. Check: Does reviewer understand full context?
75 
76IF suggestion seems wrong:
77 Push back with technical reasoning
78 
79IF can't easily verify:
80 Say so: "I can't verify this without [X]. Should I [investigate/ask/proceed]?"
81 
82IF conflicts with your human partner's prior decisions:
83 Stop and discuss with your human partner first
84```
85 
86**your human partner's rule:** "External feedback - be skeptical, but check carefully"
87 
88## YAGNI Check for "Professional" Features
89 
90```
91IF reviewer suggests "implementing properly":
92 grep codebase for actual usage
93 
94 IF unused: "This endpoint isn't called. Remove it (YAGNI)?"
95 IF used: Then implement properly
96```
97 
98**your human partner's rule:** "You and reviewer both report to me. If we don't need this feature, don't add it."
99 
100## Implementation Order
101 
102```
103FOR multi-item feedback:
104 1. Clarify anything unclear FIRST
105 2. Then implement in this order:
106 - Blocking issues (breaks, security)
107 - Simple fixes (typos, imports)
108 - Complex fixes (refactoring, logic)
109 3. Test each fix individually
110 4. Verify no regressions
111```
112 
113## When To Push Back
114 
115Push back when:
116- Suggestion breaks existing functionality
117- Reviewer lacks full context
118- Violates YAGNI (unused feature)
119- Technically incorrect for this stack
120- Legacy/compatibility reasons exist
121- Conflicts with your human partner's architectural decisions
122 
123**How to push back:**
124- Use technical reasoning, not defensiveness
125- Ask specific questions
126- Reference working tests/code
127- Involve your human partner if architectural
128 
129**If you're uncomfortable pushing back out loud:** Name that tension, then tell your partner about the issue you've seen. They'll appreciate your honesty.
130 
131## Acknowledging Correct Feedback
132 
133When feedback IS correct:
134```
135✅ "Fixed. [Brief description of what changed]"
136✅ "Good catch - [specific issue]. Fixed in [location]."
137✅ [Just fix it and show in the code]
138 
139❌ "You're absolutely right!"
140❌ "Great point!"
141❌ "Thanks for catching that!"
142❌ "Thanks for [anything]"
143❌ ANY gratitude expression
144```
145 
146**Why no thanks:** Actions speak. Just fix it. The code itself shows you heard the feedback.
147 
148**If you catch yourself about to write "Thanks":** DELETE IT. State the fix instead.
149 
150## Gracefully Correcting Your Pushback
151 
152If you pushed back and were wrong:
153```
154✅ "You were right - I checked [X] and it does [Y]. Implementing now."
155✅ "Verified this and you're correct. My initial understanding was wrong because [reason]. Fixing."
156 
157❌ Long apology
158❌ Defending why you pushed back
159❌ Over-explaining
160```
161 
162State the correction factually and move on.
163 
164## Common Mistakes
165 
166| Mistake | Fix |
167|---------|-----|
168| Performative agreement | State requirement or just act |
169| Blind implementation | Verify against codebase first |
170| Batch without testing | One at a time, test each |
171| Assuming reviewer is right | Check if breaks things |
172| Avoiding pushback | Technical correctness > comfort |
173| Partial implementation | Clarify all items first |
174| Can't verify, proceed anyway | State limitation, ask for direction |
175 
176## Real Examples
177 
178**Performative Agreement (Bad):**
179```
180Reviewer: "Remove legacy code"
181❌ "You're absolutely right! Let me remove that..."
182```
183 
184**Technical Verification (Good):**
185```
186Reviewer: "Remove legacy code"
187✅ "Checking... build target is 10.15+, this API needs 13+. Need legacy for backward compat. Current impl has wrong bundle ID - fix it or drop pre-13 support?"
188```
189 
190**YAGNI (Good):**
191```
192Reviewer: "Implement proper metrics tracking with database, date filters, CSV export"
193✅ "Grepped codebase - nothing calls this endpoint. Remove it (YAGNI)? Or is there usage I'm missing?"
194```
195 
196**Unclear Item (Good):**
197```
198your human partner: "Fix items 1-6"
199You understand 1,2,3,6. Unclear on 4,5.
200✅ "Understand 1,2,3,6. Need clarification on 4 and 5 before implementing."
201```
202 
203## GitHub Thread Replies
204 
205When replying to inline review comments on GitHub, reply in the comment thread (`gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies`), not as a top-level PR comment.
206 
View all files on GitHub →

Details

Updated
Sep 20, 2026
License
MIT
Stars on the repo
★ 289,792
Checked
Source
obra/superpowers ↗
Creator
obra · 14 listings
View creator

Similar skills

See all →
SkillCode Review ExpertHoangNguyen0403/agent-skills-standard · by HoangNguyen0403Conduct high-quality, persona-driven code reviews. Use when reviewing PRs, critiquing code quality, or analyzing changes for team feedback.★ 569 GitHub starsSkillContent ExplainerJohnQinAMD/llm-output-explainer · by JohnQinAMDExplain something in the format that is fastest to understand, from controlled English (ASD-STE100 style), to a diagram, to an interactive HTML page, to a narrated explainer video. Check facts against their sources, using parallel subagents for independent evidence streams when the host supports them. Use when the user wants to understand a substantial concept, algorithm, code change, pull request, paper, benchmark result, or agent output, or asks for an explainer, diagram, HTML explanation, STE, or video. Not for one-line answers, drafting a pull request description, or code review.★ 4 GitHub starsSkillCode Review Requesterobra/superpowers · by obraUse when completing tasks, implementing major features, or before merging to verify work meets requirements★ 290k GitHub starsSkillMulti-Axis Code Reviewaddyosmani/agent-skills · by addyosmaniConducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.★ 98.7k GitHub starsSkillCode Clarity Simplifieraddyosmani/agent-skills · by addyosmaniSimplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.★ 98.7k GitHub starsSkillGitHub Code Reviewerruvnet/RuView · by ruvnetComprehensive GitHub code review with AI-powered swarm coordination★ 94.7k GitHub stars

More from obra