code-review-excellence

Structure code reviews with phased context gathering and severity-differentiated feedback.

Updated Dec 20, 2023
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill code-review-excellence-thiago-cruz-eng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-review-excellence
Source: https://github.com/Thiago-Cruz-eng/Hibrygame/tree/main/.claude/skills/code-review-excellence
Command: npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill code-review-excellence-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams conduct consistent, high-signal code reviews that catch bugs and security issues early while improving maintainability and sharing knowledge without harming morale.

Core Features & Use Cases

  • Constructive feedback framework: Teaches how to give specific, actionable comments focused on the code, with severity labels for required changes vs suggestions.
  • Structured review workflow: Provides phased guidance for context gathering, high-level architectural review, line-by-line inspection, and an effective summary/decision.
  • Actionable review checklists and techniques: Covers security, performance, and testing checklists, plus techniques like question-based feedback and collaborative language.
  • Language-specific patterns: Includes targeted examples for Python and TypeScript/JavaScript to prevent common pitfalls (e.g., mutable defaults, unsafe typing, missing error handling).
  • Advanced review patterns: Adds guidance for architectural reviews (design-first, staged review) and test quality review (behavior vs implementation testing).

Quick Start

Use the code-review-excellence skill to review a pull request by applying its checklist and phased process, then return a prioritized decision with specific required changes, suggestions, and questions.

Frequently Asked Questions about code-review-excellence

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

FAQPage Schema
How do I do a structured code review on a pull request?▼

A structured code review applies phased guidance for context gathering, architectural checks, and line-by-line inspection to identify correctness, security, and testing gaps before approving a pull request.

What is the best way to give constructive code review feedback?▼

Constructive code review feedback uses specific, actionable comments focused on the code itself. It applies severity labels to differentiate required changes from optional suggestions, ensuring high-signal mentoring without harming morale.

Does this code review workflow support Python and TypeScript anti-pattern detection?▼

Yes, the code review workflow includes language-specific patterns for Python and TypeScript/JavaScript to prevent common pitfalls like mutable defaults, unsafe typing, and missing error handling during pull request reviews.

Can I use this skill for architecture and test quality reviews?▼

Yes, you can use it for architecture reviews using design-first, staged review patterns. It also evaluates test quality by distinguishing behavior testing from implementation testing in your pull requests.

How do I create a security and performance checklist for code reviews?▼

You create review checklists by extracting security and performance criteria from the workflow. This ensures consistent identification of vulnerabilities and bottlenecks across common software languages and team projects.

When do I need a phased code review workflow?▼

You need a phased code review workflow when teams require consistent, high-signal evaluations to catch bugs early. It structures context gathering, line-by-line inspection, and summary decisions to improve maintainability.