Skip to main content
skill CX Codex

engineering-review-feedback — Claude Code skill: code review handling

engineering-review-feedback — a skill that teaches the agent to handle reviewer comments as the change author: apply fixes, draft replies, resolve disagreements.

MIT 124 installs ★ 635 updated 2026-09-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add agentara/skills --skill engineering-review-feedback -a claude-code
Open on GitHub

What engineering-review-feedback does

The skill gives the agent a workflow for processing code review feedback. It teaches the agent to classify comments (code change required, test change required, clarification needed, disagreement to discuss), fix the code so future readers benefit rather than just explain in the review thread. When a reviewer does not understand the code, the agent simplifies the code or renames entities first, and only then adds a comment.

Includes reply templates for agreement, disagreement, and clarification scenarios. For disagreements, the agent compares tradeoffs rather than rejecting the person. Requires no FFmpeg, extra libraries, or API keys — the skill works in any editor from the list.

Adapted from Google Engineering Practices Documentation under CC-BY 3.0.

What it helps with

  • apply reviewer comments to code and tests
  • draft a reply to a pull request comment
  • resolve technical disagreement with a reviewer
  • clarify unclear requirement from review
  • summarize what changed after a feedback round

Example prompts for the agent

  • Apply the reviewer's comments from the last thread.
  • Reviewer asks to rename validateUser — what should I reply and how do I fix it?
  • I disagree with moving retry to a separate layer, draft a reply with reasoning.

How to install engineering-review-feedback

1Skills CLI (Vercel)

npx skills add agentara/skills --skill engineering-review-feedback -a claude-code

2Manually: put the files in place

~/.claude/skills/engineering-review-feedback/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/engineering-review-feedback/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about engineering-review-feedback

How to install engineering-review-feedback in Claude Code?

Run npx skills add agentara/skills --skill engineering-review-feedback -a claude-code, the skill appears at ~/.claude/skills/engineering-review-feedback/SKILL.md.

What does engineering-review-feedback do?

The skill teaches the agent to handle code review comments as the change author: classify feedback, fix code, draft replies, and resolve disagreements with reviewers.

When does the agent trigger this skill?

Triggers: "address review feedback", "respond to this review comment", "reviewer asked", "I disagree with reviewer", "what should I reply?", "apply PR comments". If the role is unclear, the agent asks whether you are the author or reviewer.

Source text

SKILL.md · MIT
---
name: engineering-review-feedback
description: >
  Use when handling code review feedback as the change author, addressing reviewer comments, drafting replies, resolving
  disagreements, or summarizing updates. TRIGGER on "address review feedback", "respond to this review comment",
  "reviewer asked", "I disagree with reviewer", "what should I reply?", or "apply PR comments". If role is unclear,
  ask reviewer or author. DO NOT TRIGGER for reviewer comment writing, full code review, or PR descriptions unless
  author-response behavior is requested.
---

# Engineering Review Feedback

Handle reviewer feedback as collaboration toward better code. The best response often changes the code, tests, or comments so future readers benefit, rather than explaining only inside the review thread.

Adapted from Google Engineering Practices Documentation, especially "How to handle reviewer comments." Source: <https://google.github.io/eng-practices/review/developer/handling-comments.html>. License: CC-BY 3.0.

## Response Workflow

1. Pause before responding if the comment feels frustrating.
2. Identify what the reviewer is asking for.
3. Classify each comment:
   - Code change required.
   - Test change required.
   - Documentation or comment change required.
   - Clarification needed.
   - Disagreement to discuss.
   - Non-blocking suggestion.
4. Prefer improving the artifact over explaining in the review tool.
5. Run the relevant verification.
6. Reply with what changed, why, and how it was tested.

If a reviewer says they do not understand the code, first try to make the code clearer. Add a code comment only when the why cannot be expressed cleanly in code.

## When You Agree

Use a short response and make the change.

```text
Done. I renamed the helper to describe normalization rather than validation and updated the two call sites.

Tested with: npm test -- user-profile.test.ts
```

## When You Need Clarification

Ask for the missing decision or constraint. Avoid defensive wording.

```text
I want to make sure I understand the concern. Are you asking for this to reject duplicate requests at the API boundary, or for the worker to make duplicate processing idempotent?
```

## When You Disagree

Disagree by comparing tradeoffs, not by rejecting the person.

```text
I chose X because it keeps the retry policy in one place and avoids a second queue state. My concern with Y is that it makes cancellation observable in two different layers.

If you think Y better serves the rollback requirement, I can switch to it. Is that the tradeoff you want prioritized?
```

If the reviewer provides better technical reasoning, accept it and adjust. If neither side can converge, move to a higher-bandwidth conversation and summarize the decision back in the review.

## When Feedback Is Not Constructive

Do not reply in kind. Extract any technical concern that can be addressed in code, tests, or docs. If the comment is hostile, vague, or repeatedly unproductive, move to a private or higher-bandwidth conversation, involve a lead when needed, and summarize only the technical decision back in the review.

## Fix the Right Place

- Confusing expression: simplify or rename it.
- Hidden invariant: encode it in types, validation, assertions, or a focused comment.
- Missing behavior confidence: add or improve tests.
- Missing context: update the PR description, code comment, README, or design doc.
- Reviewer misunderstanding caused by stale diff: rebase, remove dead code, or update the description.
- Pure preference: ask whether it is required; otherwise treat as optional.

## Summary Reply Template

```markdown
Addressed this round:
- Changed ...
- Added/updated tests for ...
- Clarified ...

Verification:
- `...`

Open:
- ...
```

## Common Mistakes

- Replying in anger or with sarcasm.
- Explaining confusing code only in the review thread.
- Treating every reviewer suggestion as mandatory without clarifying severity.
- Saying "will clean up later" when the current change introduces the complexity.
- Making broad unrelated refactors while addressing a narrow review comment.

© agentara · MIT · agentara/skills

Similar skills

All skills for Code review and refactoring →

From the same set20

The whole set →
feature-dev-loop feature-dev-loop orchestrates multi-step feature development: planning, subagent reviews, TDD execution, and HTML acceptance reports. CX Codex +1 187installs publish-research-site The publish-research-site skill turns a topic or thesis into an interactive, image-rich site backed by citations, then deploys it with Vercel CLI. Use it to publish a research report or an interactive story. CX Codex +1 142installs torn-paper-collage-poster Generates image-generation prompts and workflows for editorial torn-paper collage posters with ripped edges, tape, and stamps. CX Codex +1 135installs engineering-small-prs engineering-small-prs turns a large feature, refactor or migration into small pull requests, with a merge order and a rollback plan. CX Codex +1 133installs engineering-code-review engineering-code-review applies Google engineering practices to review pull requests and local diffs. Focuses on overall code health, tests, and risk without nitpicking style. CX Codex +1 131installs engineering-review-comments engineering-review-comments turns rough review notes into PR comments with a severity label, an engineering reason and a concrete ask. CX Codex +1 125installs engineering-change-descriptions engineering-change-descriptions is a Claude Code skill for drafting and rewriting PR descriptions, commit messages, and change summaries, including what changed, why, and how it was checked. CX Codex +1 124installs engineering-emergency-changes The engineering-emergency-changes skill checks whether an urgent change merits an expedited process, then guides the agent through narrowing the fix, checking risks, and planning follow-up review. CX Codex +1 123installs

Project sponsors

Companies that keep this analytics open