Codex Skills Registry
← Back to registry
Skill

code-reviewer

"High-signal code review workflow for pull requests and patches: correctness, readability, API/UX, performance, security, and maintainability. Use when reviewing diffs/PRs, writing review comments, proposing fixes, or producing a structured review report with actionable follow-ups."

Categoryquality
Last updated2026-01-19
View on GitHub
Install

One-line setup

Copy and run this in your terminal to install the skill. Re-run to reinstall and update an existing install.

npx codex-skills-registry@latest --skill=quality/code-reviewer --yes

Code Reviewer

Give reviews that help the author ship safely and quickly.

Quick Start

  1. Understand intent: what’s the user-facing / system-facing change and why?
  2. Review in this order:
    • Correctness (edge cases, invariants, error handling)
    • Safety (security + data handling + secrets)
    • Maintainability (structure, naming, interfaces)
    • Performance (hot paths, I/O, allocations, DB queries)
    • Tests (do they fail before the fix? do they cover the right behavior?)
  3. Leave comments that are:
    • Actionable (what to change) + why (risk/benefit) + scope (must vs nice-to-have)

Large diff triage (use when the change is big)

  • Start with the entrypoints and high-risk files (auth, payments, data writes).
  • Identify invariants the change must preserve, then hunt for violations.
  • Skim for mechanical changes and collapse them; focus deep review on behavioral deltas.

When to request changes

  • Bugs or correctness issues that can ship user-impacting failures.
  • Security/privacy regressions or data handling gaps.
  • Missing or inadequate tests for new behavior or fixed bugs.

Output format (recommended)

  • Summary: what the change does
  • Major issues: must-fix items (blockers)
  • Minor suggestions: improvements / nits
  • Test plan: how to validate locally/CI
  • Follow-ups: tickets/cleanup that shouldn’t block merge

Optional tool: generate a review report from git diff

From the repo you’re reviewing:

python ~/.codex/skills/code-reviewer/scripts/review_diff.py --base origin/main --out /tmp/review.md

References

  • Review checklist and comment style: references/review-checklist.md