full-code-review

Guide maintainers through a five-phase branch-level code review before pull requests.

11|1|Updated Jun 7, 2025
One-click install
npx skills add https://github.com/baseballyama/eslint-plugin-postgresql --skill full-code-review-baseballyama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: full-code-review
Source: https://github.com/baseballyama/eslint-plugin-postgresql/tree/main/.claude/skills/full-code-review
Command: npx skills add https://github.com/baseballyama/eslint-plugin-postgresql --skill full-code-review-baseballyama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides maintainers through a rigorous, branch-level code review before pulling requests, ensuring intent, design alignment, implementation quality, and documentation are evaluated in a structured, collaborative process.

Core Features & Use Cases

  • Phase-driven review: Executes a five-phase workflow (baseline establishment, justification, design & implementation checks, docs/tests validation, final summary) to surface issues early.
  • Verbatim verdicts & next steps: Produces clear, actionable outcomes (Justified, Out of scope, Unclear, etc.) with recommended follow-up actions.
  • Collaborative, staged feedback: Requires agreement on findings phase-by-phase before moving forward to ensure alignment and accountability.
  • Scope and change categorization: Guides the reviewer to identify the public API surface, internal changes, tests, documentation, and tooling impacts.

Quick Start

Initiate a full-code-review on the target branch to begin Phase 1 and progress through all five phases.

Frequently Asked Questions about full-code-review

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

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

A structured code review before a PR evaluates why the change exists, whether the design is sound, and if implementation, tests, docs, and changelog are complete, ensuring issues are surfaced early rather than during PR approval.

What is the best way to categorize code changes during a branch review?

Categorizing code changes during a branch review involves identifying the public API surface, internal modifications, test impacts, documentation updates, and tooling adjustments to assess the full scope of the modification.

How does a phased code review process work for maintainers?

A phased code review process works by executing a five-step workflow: establishing the baseline branch, validating change justification, checking design and implementation, validating docs and tests, and delivering a final summary with actionable verdicts.

Can I get actionable verdicts from a pre-PR code review?

Yes, a pre-PR code review produces verbatim verdicts such as Justified, Out of scope, or Unclear, each paired with recommended follow-up actions to guide the maintainer's next steps.

Does collaborative code review require phase-by-phase agreement?

Collaborative code review requires phase-by-phase agreement to ensure alignment and accountability, preventing the review from advancing to the next stage until findings are confirmed.

What should I check when validating documentation in a code review?

When validating documentation in a code review, check that tests, docs, and changelog entries are fully updated to reflect the categorized scope of public API and internal changes.