code-review-best-practices

Review pull requests and diffs with structured checklists for security and performance.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/zoeyzou/friend-sync --skill code-review-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-best-practices
Source: https://github.com/zoeyzou/friend-sync/tree/main/.cursor/skills/code-review-best-practices
Command: npx skills add https://github.com/zoeyzou/friend-sync --skill code-review-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps reviewers quickly and consistently identify correctness, security, scalability, performance, code reuse, and maintainability issues in repository changes, reducing missed bugs and improving review quality and actionability.

Core Features & Use Cases

  • Structured checklists for correctness, security, scalability, code reuse, and maintainability tailored to backend (Prisma/tRPC/NextAuth) and frontend (Next.js, shadcn) changes.
  • Guidance to scan diffs by logical groups (backend, frontend, config/tooling) and produce concrete findings grouped by severity (Critical, Major, Minor) with remediation suggestions and a reusable response template.
  • Use cases include pull request reviews, security hardening of auth/API changes, detecting N+1 and performance regressions, consolidating duplicated components, and surfacing missing tests or type gaps.

Quick Start

Review pull request #123 by summarizing its domain, scanning backend and frontend diffs using the security and performance checklists, and returning findings grouped by severity with concrete suggestions using the provided template.

Frequently Asked Questions about code-review-best-practices

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

FAQPage Schema
How do I perform a structured code review for a pull request?

To perform a structured code review, scan pull request diffs by logical groups like backend and frontend, applying checklists for security and scalability to group findings by severity with concrete remediation suggestions.

What should I check during a security review of Next.js and tRPC API changes?

During a security review of Next.js and tRPC changes, use a structured checklist to identify authorization gaps in NextAuth, validate API inputs, and surface potential vulnerabilities grouped by severity with actionable fixes.

How do I detect N+1 queries and performance issues in Prisma database changes?

To detect N+1 queries in Prisma changes, scan pull request diffs for inefficient database access patterns using a performance checklist, grouping any identified regressions by severity with concrete remediation steps.

Does this code review approach work for both frontend and backend changes?

Yes, this code review approach works for both contexts, applying tailored checklists to backend technologies like Prisma and tRPC alongside frontend frameworks like Next.js to ensure comprehensive coverage across the stack.

What is the best way to organize code review feedback for maintainability?

The best way to organize code review feedback for maintainability is grouping findings by severity—Critical, Major, and Minor—using a reusable response template that highlights code reuse opportunities and missing tests.

Why group code review findings by severity instead of listing them chronologically?

Grouping code review findings by severity instead of chronologically helps developers prioritize critical security and correctness issues first, ensuring that major scalability and performance regressions are addressed before minor maintainability suggestions.