Skip to content

Guide · Agent skill

How to use the Receiving Code Review agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The receiving-code-review skill is an instruction file for an AI coding agent. It tells the agent how to handle code review feedback on your work: read it fully, check it against the real codebase, ask about anything unclear, and push back with technical reasons when a suggestion looks wrong. This guide covers what the skill changes, how to install it, how to trigger it, and where to be careful. You do not need prior experience with agent skills to follow it.

Receiving Code ReviewjnMetaCode/superpowers-zh · MIT

Quick start

  1. 1Download the ZIP. Get the receiving-code-review ZIP from this page and unzip it. It contains SKILL.md.
  2. 2Place the skill folder. Copy it to ~/.claude/skills/ for personal use, or to a project's .claude/skills/ folder for one repository.
  3. 3Or upload in the Claude apps. If you use the Claude apps, go to Settings → Capabilities → Skills and upload the skill there.
  4. 4Send your review feedback. Paste the review comments or point the agent at the PR, and say you want them checked against the code first.
  5. 5Answer clarifying questions. If the agent flags unclear items, answer them before it changes anything.
  6. 6Implement and test one item at a time. Let the agent fix items individually and run tests between them to catch regressions.
  7. 7Reply in the GitHub thread. For inline GitHub comments, have replies posted inside the comment thread using the GitHub CLI, after you check the target.

What the receiving-code-review skill makes the agent do

The skill sets a working order for review feedback: read the whole list, restate or question each item, verify it against the code, assess whether it is technically sound for this codebase, respond, then implement one item at a time with testing in between.

It tells the agent to avoid empty agreement such as "you're absolutely right" and to state what was fixed instead. When feedback is unclear, the agent should stop and ask about the unclear items before implementing anything, because related items may depend on each other.

  • Ask clarifying questions when any item in the feedback is unclear.
  • Check external reviewer suggestions for breaking changes, missing context, and unused features (YAGNI).
  • Push back with technical reasons when a suggestion would break existing behaviour or is incorrect for the stack.
  • Fix blocking issues first, then simple fixes, then complex ones, testing each one.
  • Reply to GitHub inline review comments inside the comment thread, not as a top-level PR comment.

Install the skill from the ZIP

Download the ZIP for this skill from this page and unzip it. The skill is a single file named SKILL.md. Place the unzipped skill folder in one of two locations: your personal skills folder at ~/.claude/skills/, or a project-specific .claude/skills/ folder inside the repository you are working on.

If you use the Claude apps instead of a local folder, you can upload the skill under Settings → Capabilities → Skills.

  • Personal use across projects: put the skill in ~/.claude/skills/.
  • Shared with one repository: put the skill in that project's .claude/skills/ folder.
~/.claude/skills/

How to trigger the skill with natural requests

You do not need a special command. The skill describes itself as applying after you receive code review feedback and before you act on it, especially when feedback is vague or technically questionable. Give the agent the review comments and say what you want done with them.

Requests that match the skill's purpose include asking the agent to evaluate comments rather than apply them, or asking it to take a list of review items one at a time.

  • "Here are the review comments on my PR. Check each one against the code before changing anything."
  • "The reviewer wants items 1 to 6 fixed. Tell me if any of them are unclear before you start."
  • "This reviewer suggests adding a generic helper. Is anything calling it? Push back if it isn't needed."
  • "Respond to these inline GitHub comments in their threads."

Example: handling a review comment

Suppose a reviewer writes "Remove the legacy code." Instead of deleting it, the agent checks the project. In the source's worked example, the agent finds that the build target is 10.15 or later while the API in question needs 13 or later, so the legacy code is needed for backward compatibility. It then replies with that finding and asks whether to fix the incorrect bundle ID or drop support for versions before 13.

In another example, a reviewer asks for full metrics tracking with database, date filtering and CSV export. The agent searches the codebase, finds nothing calls the interface, and asks whether to delete it under the YAGNI principle or whether it missed a caller.

What you need before you start

The skill assumes a software codebase and a review workflow. You need access to the code, plus a pull request or written review feedback to work from. For replying to GitHub inline review comments, the skill references the GitHub CLI (gh) and a replies API endpoint for pull request comments.

The skill contains no scripts and does not use the network on its own. The GitHub reply step is the only tool-specific instruction in the file.

  • Access to the codebase the feedback applies to.
  • A PR or written review feedback.
  • The GitHub CLI (gh), only if you want replies posted to GitHub comment threads.
gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies

Safety notes: scripts and network

The skill runs no scripts and uses no network access according to its listing. Its main effect is on how the agent reasons and what text it writes. Changes to code still happen through the agent's normal tools in your project, so review the diffs it produces as you would for any change.

The reply command above posts to GitHub on your behalf when used. Check the target pull request and comment ID before the agent posts.

  • Review any code changes the agent makes before merging.
  • Confirm the repository, PR number and comment ID before any GitHub reply is posted.

Tips for getting good results

Give the agent the full feedback in one message so it can see dependencies between items. Ask it to verify before implementing, and expect it to report what it checked. If you want the agent to simply apply every comment, this skill will work against that, so choose a different approach for that workflow.

  • Paste all review items at once so related items are read together.
  • Ask for one fix at a time and a test run after each.
  • Keep the "what was fixed" style: short, factual replies.

What people use it for

  • Evaluating reviewer suggestions that would remove code still needed for backward compatibility.
  • Declining or questioning features a reviewer wants but nothing in the codebase uses.
  • Working through a numbered list of review items one at a time, with clarifying questions first.
  • Replying to GitHub inline review comments within their threads.

Frequently asked questions

How do I install the receiving-code-review skill?

Download the ZIP from this page and unzip it. Put the skill folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder. In the Claude apps, you can upload it under Settings → Capabilities → Skills.

Is the receiving-code-review skill free?

The skill is listed under the MIT licence. Check the licence file in the source repository for the full terms before redistributing it.

What does the receiving-code-review skill require?

You need access to the codebase and a PR or review feedback to work from. The GitHub CLI (gh) is needed only for replying to GitHub inline review comments. The skill runs no scripts and uses no network.

Does the skill make Claude argue with reviewers?

Not by default. It asks for verification and clarification, and it pushes back only when a suggestion has a technical problem such as breaking existing behaviour, being unused, or conflicting with an architecture decision.

Does this skill work for projects not on GitHub?

The general review-handling guidance works anywhere. The only tool-specific instruction covers replying to GitHub inline review comments, so it adds little for projects on other platforms.

How is this different from just asking an agent to fix review comments?

A plain request often leads the agent to apply every comment. This skill asks it to check each comment against the codebase, ask about unclear items, and implement one fix at a time with testing.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you want an AI agent to evaluate review feedback before acting on it, especially from external reviewers or on teams that test each change. Pick a different approach if you want every comment applied without discussion, if you are not working with a software codebase, or if you need tool support beyond GitHub inline replies.

Download the skill