canon-pr-review

Evaluate GitHub pull requests against software engineering best practices and post a review decision.

4|Updated Feb 23, 2026

Search Tags:#code quality #github #maintainability #reliability #engineering best practices #module design #pull request review

Ready to run

npx skills add https://github.com/npow/claude-skills --skill canon-pr-review-npow

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: canon-pr-review
Source: https://github.com/npow/claude-skills/tree/main/canon-pr-review
Command: npx skills add https://github.com/npow/claude-skills --skill canon-pr-review-npow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams perform rigorous, consistent pull request reviews against established software engineering principles instead of relying on ad hoc judgment.

Core Features & Use Cases

Structured Standards Review: Evaluates code quality, module design, reliability, and maintainability across 20 practices drawn from seminal engineering books.
Evidence-Based Findings: Identifies concrete violations with file locations, line numbers, verbatim excerpts, severity scores, and suggested improvements.
Decision Support: Produces a formatted GitHub PR comment with dimension scores and an APPROVE, REQUEST_CHANGES, or BLOCK recommendation.
Use Case: Apply the Skill to a feature or bug-fix pull request to detect missing timeouts, swallowed exceptions, weak test coverage, excessive coupling, or unmaintainable implementation patterns before merging.

Quick Start

Ask the canon-pr-review skill to review pull request 42 against engineering best practices in the current repository.

Frequently Asked Questions about canon-pr-review

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

FAQPage Schema

How do I automate pull request reviews for engineering best practices?▼

Automated pull request reviews apply a structured set of software engineering principles to evaluate code quality, module design, reliability, and maintainability. This skill scores pull requests against proven practices and posts an evidence-based decision directly to GitHub.

What code quality issues can an automated PR review detect?▼

An automated PR review detects missing timeouts, swallowed exceptions, weak test coverage, excessive coupling, and unmaintainable implementation patterns. It identifies concrete violations with verbatim excerpts, file locations, and line numbers from the GitHub diff.

How do I review GitHub pull requests for maintainability and module design?▼

Reviewing GitHub pull requests for maintainability involves evaluating the code diff against 20 practices drawn from seminal engineering books. This skill analyzes the code structure and produces an evidence-based review comment with dimension scores.

Does automated code review work with refactoring and maintenance pull requests?▼

Automated code review works with GitHub feature, bug-fix, refactoring, and maintenance pull requests. It requires access to the repository Git history, GitHub pull request metadata, and GitHub CLI capabilities to retrieve context and post structured findings.

What is the best way to enforce engineering standards before merging a pull request?▼

Enforcing engineering standards before merging requires evaluating the pull request diff against established software engineering principles. This skill generates a formatted GitHub PR comment with severity scores and an APPROVE, REQUEST_CHANGES, or BLOCK recommendation.

Why do inconsistent code reviews miss maintainability violations?▼

Inconsistent code reviews miss maintainability violations by relying on ad hoc judgment instead of structured software engineering standards. Applying a rigorous evaluation to the pull request diff ensures concrete violations are identified with suggested improvements.