Skip to content

Code Review Excellence

Guides the agent to give constructive, prioritized, and well-framed code review feedback.

Repository
wshobson/agents
Stars
42,095
Licence
MIT
Files
3 files

What it does

When installed, the agent follows a structured code review process when you ask it to review a pull request or code change. It checks logic, edge cases, security, performance, tests and maintainability in phases, and writes feedback that is specific, labels severity (blocking vs. optional), and explains the reason behind each comment. It also helps with handling disagreements, reviewer templates, and team review standards, using reference checklists it loads on demand.

Great for

  • Developers who want a consistent, thorough checklist for reviewing pull requests
  • Tech leads writing review standards or mentoring junior developers through reviews
  • Teams who want review comments that are constructive rather than judgmental

Skip it if

  • Replacing automated tools: the skill itself says formatting and linting should be handled by tools like Prettier or Black, so it will not check style well on its own
  • Security-critical sign-off: its security checklist is a general prompt list, not an audit, so a human security review is still needed for sensitive code

Try asking

  • “Review this pull request diff and tell me what blocking issues you see, with severity labels.”
  • “Draft constructive review comments for this PR that explain why each change matters.”
  • “Create a code review checklist for our team's backend services.”
  • “Help me respond to a reviewer who disagrees with my approach in this thread.”
Step-by-step guide: how to use Code Review ExcellenceInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 3 original files, the MIT licence and an attribution note.

    code-review-excellence.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip code-review-excellence.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip code-review-excellence.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

  • Paste the diff or point the agent at the changed files, and include the PR description so it can check the business requirement.
  • Ask for the output in the PR Review Comment Template format to get a ready-to-post structure.
  • Tell the agent your language or framework so it loads the matching language-specific checks from the reference files.

What's inside

  • references/review-patterns.md
  • references/review-techniques.md
  • SKILL.md

Redistributed unmodified from wshobson/agents under the MIT 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.