code-review-checklist

Apply a structured code-review-checklist to validate pull requests across nine categories.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/phrazzld/claude-config --skill code-review-checklist-phrazzld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-checklist
Source: https://github.com/phrazzld/claude-config/tree/main/skills/code-review-checklist
Command: npx skills add https://github.com/phrazzld/claude-config --skill code-review-checklist-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent or superficial code reviews miss critical issues, leading to bugs, security vulnerabilities, and technical debt. This Skill provides a fast, focused checklist to ensure comprehensive code quality, correctness, and maintainability.

Core Features & Use Cases

  • Comprehensive Categories: Covers purpose, design, quality, correctness, security, performance, testing, and documentation for a holistic review.
  • Red Flag Identification: Helps quickly spot critical issues like security vulnerabilities, N+1 queries, and missing error handling.
  • Quick Decision Guide: Provides clear guidance on when to block a PR, request changes, or suggest improvements, streamlining the review process.
  • Use Case: When reviewing a pull request, activate this Skill to automatically apply the checklist, flagging potential issues in naming, error handling, security, and test coverage, ensuring nothing is missed.

Quick Start

Apply the code-review-checklist skill to review the attached pull request. Focus on correctness and security.

Frequently Asked Questions about code-review-checklist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I conduct a thorough code review without missing critical issues?

A structured code review process systematically evaluates purpose, design, quality, correctness, security, performance, testing, and documentation. This checklist-driven approach flags red flags like security vulnerabilities, N+1 queries, and missing error handling, ensuring comprehensive coverage across all quality dimensions and reducing gaps that lead to bugs and technical debt.

What should I look for when reviewing a pull request for security and correctness?

Code review should validate security practices, error handling, and logic correctness by checking for vulnerabilities, improper input validation, unhandled exceptions, and design flaws. A structured checklist identifies these issues systematically across categories like security, correctness, and best practices, preventing vulnerabilities from reaching production.

How do I decide whether to block a PR or request changes during code review?

A structured review process provides clear decision guidance by categorizing findings: blocking issues include security vulnerabilities and critical correctness problems, while suggested improvements cover performance, documentation, and testing gaps. This framework streamlines the review decision by distinguishing severity levels and actionable feedback.

What makes code review inconsistent across a team, and how do I fix it?

Inconsistent reviews miss issues because reviewers apply different standards and focus areas. A standardized checklist covering purpose, design, quality, correctness, security, performance, testing, and documentation ensures every PR receives consistent evaluation, reducing gaps and technical debt accumulation.

Can I use a code review checklist during pair programming or self-review?

Yes, structured code review checklists apply to self-reviews and pairing sessions, not just pull request reviews. The same category-based evaluation of correctness, security, performance, and testing helps catch issues early, whether reviewing your own code or collaborating in real time.