code-review-excellence

Structure pull request reviews with phase-based workflows and feedback templates.

Updated Dec 8, 2025
One-click install
npx skills add https://github.com/Tianyi-Billy-Ma/PyTemplate --skill code-review-excellence-tianyi-billy-ma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-excellence
Source: https://github.com/Tianyi-Billy-Ma/PyTemplate/tree/main/.dev/ai/skills/skills/code-review-excellence
Command: npx skills add https://github.com/Tianyi-Billy-Ma/PyTemplate --skill code-review-excellence-tianyi-billy-ma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It transforms code reviews from gatekeeping into constructive, educational moments by providing structured guidance, checklists, and templates that help teams improve code quality.

Core Features & Use Cases

  • Phase-based process: Context gathering, high-level review, line-by-line critique, and summary decisions.
  • Feedback templates: Examples that are specific, actionable, and balanced.
  • Review scope & checklists: Guidance for architecture, security, performance, tests, and documentation.

Quick Start

Start by selecting a PR, then apply the four-phase review flow and use the included templates to structure your feedback.

Frequently Asked Questions about code-review-excellence

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

FAQPage Schema
How do I structure code review feedback to be more actionable and specific?

Code review feedback should combine context gathering, high-level analysis, line-by-line critique, and summary decisions. Use structured templates that address correctness, security, performance, testing, maintainability, and architecture—delivering balanced, specific examples rather than vague observations.

What should a code review checklist include for pull requests?

A comprehensive PR review checklist covers architecture alignment, security vulnerabilities, performance implications, test coverage, and documentation completeness. Phase-based guidance ensures consistent scope across reviews and helps teams establish shared standards.

How do I turn code reviews into learning experiences for my team?

Transform reviews from gatekeeping into mentoring by applying structured feedback templates, establishing clear review standards, and providing guidance tied to specific categories. Actionable feedback with examples helps developers understand *why* changes matter.

Can I use code review templates with my existing review process?

Yes. Templates and checklists are compatible with established review workflows and automation. They integrate into PR review phases—context gathering, high-level review, detailed critique, and summary—without replacing your current tools or process.

What's the difference between architectural reviews and standard code reviews?

Architectural reviews focus on system-level alignment, design patterns, and scalability; standard reviews address code quality and correctness. This Skill provides separate guidance for both, ensuring reviews match their scope and stakeholders.

How do I ensure consistency across my team's code reviews?

Establish shared review standards, apply consistent checklists covering security, performance, testing, and maintainability, and use templated feedback. Phase-based structure—context, high-level, line-by-line, summary—standardizes how reviews are conducted across reviewers.