Skip to content

Code Review and Quality

Gives the agent a five-axis checklist for reviewing code before it merges

Stars
112,668
Licence
MIT
Files
1 file

What it does

When installed, the agent reviews code changes (diffs, pull requests, or code pasted into chat) against five areas: correctness, readability and simplicity, architecture, security, and performance. It also checks that changes are a reasonable size and suggests specific restructurings rather than only pointing out problems. The file is written as guidance for the agent's reasoning; it does not itself run any tools.

Great for

  • Developers who want a consistent, thorough checklist for reviewing their own or teammates' code
  • Teams reviewing code produced by AI agents or other models before it is merged
  • Reviewers who want review comments that propose concrete fixes

Skip it if

  • Replacing human sign-off on security-critical or production code, since the agent's review can miss issues and the skill gives no tool-based verification (reason: it is guidance only)
  • Non-programmers who need code explained from scratch (reason: the skill assumes familiarity with software engineering terms)

Try asking

  • “Review this pull request diff and tell me what should block the merge”
  • “Check this function I wrote for edge cases and error handling before I open a PR”
  • “Review the code another agent just generated for this feature and flag design smells”
  • “Is this 1,200-line change reasonable? Suggest how to split it”
Step-by-step guide: how to use Code Review and QualityInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    code-review-and-quality.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip code-review-and-quality.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 to the changed files, and say what the change is supposed to do so it can check correctness against the spec.
  • Ask for the review by axis (for example, only security) if you want a shorter, focused result.
  • Treat the output as a first-pass review; keep a human reviewer for final approval, especially for security-sensitive changes.

What's inside

  • SKILL.md

Redistributed unmodified from addyosmani/agent-skills 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.