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 a set of instructions that tells an AI agent how to handle code review comments it receives, such as comments on a pull request. Instead of accepting every suggestion or replying with praise, the agent reads the feedback, checks it against your codebase, and then fixes it or pushes back with reasons. This guide explains what the skill does, how to install it, how to trigger it, and what to watch for.

Receiving Code Reviewobra/superpowers · MIT

Quick start

  1. 1Download the skill. Download the ZIP file for receiving-code-review from this page. The package contains SKILL.md.
  2. 2Choose where to install it. Use ~/.claude/skills/ for all your projects, or the .claude/skills/ folder inside one project. In the Claude apps, use Settings → Capabilities → Skills instead.
  3. 3Unzip or upload the skill. Unzip the download into the chosen skills folder, or upload the ZIP under Skills in the Claude apps.
  4. 4Install the GitHub CLI if needed. If the agent will reply to GitHub inline comments, make sure the GitHub CLI (gh) is installed and can access your repository.
  5. 5Give the agent the review feedback. Paste or point the agent to the review comments and ask it to address them, and say whether it should push back on anything.
  6. 6Check the replies before they post. Read the agent's proposed replies and fixes, since GitHub replies are public once posted.

What does the receiving-code-review skill make the agent do?

The skill covers one part of the review process: receiving feedback. It is not for writing new code or doing a first-pass review. Its source describes a response pattern the agent follows: read the complete feedback without reacting, restate the requirement in its own words (or ask), verify it against the codebase, evaluate whether it is technically sound for this codebase, respond with a technical acknowledgment or reasoned pushback, and then implement one item at a time while testing each.

  • Verifies suggestions against the actual codebase before implementing them.
  • Avoids empty replies such as 'You're absolutely right!' or 'Great point!'.
  • Stops and asks for clarification when any item in a batch is unclear, rather than guessing.
  • Pushes back with technical reasoning when a suggestion breaks existing functionality, conflicts with a prior decision, or seems unnecessary (for example, an unused feature).
  • Replies to GitHub inline review comments inside their existing thread.

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

Download the ZIP file for the skill from this page. The skill's file is SKILL.md. You can install it in one of two ways.

For Claude Code, unzip the download into your user skills folder at ~/.claude/skills/ so it is available in all your projects. To limit it to one project, unzip it into that project's .claude/skills/ folder instead.

In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP there.

  • Personal install: ~/.claude/skills/
  • Project install: the .claude/skills/ folder inside your project
  • Claude apps: Settings → Capabilities → Skills

How do you trigger the skill with natural requests?

You do not need a special command. The skill's description tells the agent to use it when it receives code review feedback, before implementing suggestions, especially when feedback seems unclear or technically questionable. So the simplest way to trigger it is to give the agent the review comments and ask it to address them in a normal way.

You can also name the situation directly so the agent knows the context is review feedback and not a new task.

  • 'Here are the review comments on my pull request. Address them, and push back where a suggestion looks wrong.'
  • 'The reviewer wants me to remove this endpoint. Check whether anything calls it before changing anything.'
  • 'Go through these inline comments and reply in each thread once you have checked the code.'
  • 'Items 4 and 5 in this review are unclear. Ask me what they mean before you change anything.'

What does a good reply look like?

The skill's examples contrast weak and strong replies. A weak reply agrees without checking. A strong reply shows the agent looked at the code, states what it found, and either makes the change or asks a specific question.

In the source's example, a reviewer asks to remove legacy code. The agent checks the build target and the API it needs, finds a compatibility reason to keep the code, and asks whether to drop support for older versions. The reply is short, factual and gives the human a decision to make.

  • Weak: 'You're absolutely right! Let me remove that...'
  • Strong: 'Checking... build target is 10.15+, this API needs 13+. Need legacy for backward compat. Fix it or drop pre-13 support?'
  • When feedback is correct: 'Fixed. [Brief description of what changed]'
  • When you were wrong to push back: state the correction factually and move on, without a long apology.

How does the skill handle GitHub inline review comments?

When the agent replies to an inline review comment on GitHub, the skill tells it to reply inside the comment's thread, not as a new top-level comment on the pull request. The skill gives the GitHub CLI command pattern it uses for this.

  • Requires the GitHub CLI (gh) to be installed and available to the agent.
  • Replies go into the existing thread of the review comment.
gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies

What are the safety notes?

This skill runs no scripts. It does use the network, because replying to GitHub comments means running gh api commands that post to the public pull request. Those replies are visible to everyone who can see the pull request.

Because of this, do not use the skill in an automated pipeline that posts replies to GitHub without a person checking them first. Review the agent's replies before they are posted, especially when the agent is pushing back on a reviewer.

  • Runs scripts: no
  • Uses network: yes, through gh api commands
  • Replies are posted publicly on GitHub
  • Keep a human in the loop before replies go out

What tips help the skill work well?

The skill works best when the agent has access to the real codebase, so it can verify claims instead of guessing. Give it full review context when you can, and tell it how much to trust each source. The skill's own guidance is to treat your own instructions as trusted and external reviewer feedback as something to check carefully.

If the agent says it cannot verify something, answer its question. The skill is designed to state the limit and ask for direction rather than proceed blindly.

  • Make sure the agent can read the repository it is reviewing.
  • Send all items in a batch together so it can spot items that depend on each other.
  • Tell the agent about architectural decisions that reviewers may not know about.
  • Ask it to test each change separately when you have several fixes.

What people use it for

  • Working through a pull request with many inline comments, where the agent checks each one against the code before changing anything.
  • Handling a reviewer suggestion that asks for a feature nothing in the codebase uses, so the agent asks whether to remove it instead of adding it.
  • Sorting a batch of review items into clear and unclear, so the agent fixes the clear ones only after asking about the rest.
  • Replying in GitHub threads with short, factual answers instead of praise or long apologies.

Frequently asked questions

Is the receiving-code-review skill free to use?

The skill is published under the MIT licence, as stated on this page. Check the licence text in the source repository for the full terms.

What do I need to use the receiving-code-review skill?

You need an AI agent that supports skills and the GitHub CLI (gh) if you want the agent to reply to inline review comments on GitHub. The skill runs no scripts, but it does use the network through gh api commands.

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

Unzip the downloaded ZIP into ~/.claude/skills/ for all projects, or into a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.

Will the agent post replies to GitHub automatically?

The skill tells the agent how to reply inside a comment thread using gh api. Because those replies are posted publicly, review them before they go out and avoid fully automated posting without a human check.

Can I stop the agent from accepting every review suggestion?

Yes, this is the purpose of the skill. It tells the agent to verify suggestions and push back when they seem wrong, so you do not need to tell it to question each one.

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

Without the skill, an agent may implement feedback immediately or reply with praise. This skill adds steps to verify each item against the codebase, ask about unclear items, and avoid empty replies.

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

This skill suits developers who use an AI agent to handle pull request feedback and want it to check reviewer suggestions before acting. It is not a good fit if you mainly want the agent to write new code, if you want it to accept every suggestion without question, or if you plan to post its GitHub replies automatically without a human reading them first.

Download the skill