Skip to content
Get packs

GitHub PR Review (Human-Voiced)

Reviews a GitHub pull request and drafts inline comments for your approval before posting them one by one

Source Download skill
Repository
google/adk-recipes
Stars
10,568
Licence
Apache-2.0
Files
14 files

What it does

When you ask an agent to review a GitHub pull request, this skill makes it follow a bounded, staged process: plan the review by PR size, analyse the changed files (optionally in parallel sub-agents), keep only findings a reader can verify by looking at the anchored line, write them in a calibrated human-style voice, and show you the full draft. Only after you approve does it post the comments to GitHub, paced one at a time. It also reads existing comments so re-reviews don't repeat what was already said.

Great for

  • Maintainers who want a first-pass review of a PR with a short list of checkable comments
  • Contributors reviewing a teammate's PR who want a draft to edit before posting
  • Teams re-reviewing a PR after a bot or colleague has already commented

Skip it if

  • Reviewing local uncommitted changes or a branch diff (the skill says to use the separate review skill instead)
  • Anyone wanting a deep audit for themselves: the skill deliberately limits depth, so it will miss deeper issues
  • Posting reviews you have not read: the skill is designed around your approval, and its style is aimed at making comments look hand-typed, which can conceal AI origin from PR authors if misused

Try asking

  • “review PR 123”
  • “review this PR https://github.com/owner/repo/pull/456”
  • “leave comments on this pull request in a human reviewing voice”
Step-by-step guide: how to use GitHub PR Review (Human-Voiced)Install, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 14 original files, the Apache-2.0 licence and an attribution note.

    github-pr-review.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip github-pr-review.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip github-pr-review.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Set SKILL_DIR to your install location before running commands, as the SKILL.md instructs.
  • Read every draft comment before approving; the approval step is where you take ownership of the review.
  • Run the skill's tests (tests/) after editing it, since the source notes they run in the adk-samples CI.

What's inside

  • reference/lane-prompt.md
  • reference/rationale.md
  • reference/voice.md
  • scripts/build_report.py
  • scripts/existing_comments.py
  • scripts/plan_review.py
  • scripts/post_comments.py
  • scripts/rejections.py
  • scripts/verify_findings.py
  • SKILL.md
  • tests/conftest.py
  • tests/fixtures/pr2373_outcomes.json
  • tests/test_build_report.py
  • tests/test_check_house_rules.py

Redistributed unmodified from google/adk-recipes under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.