Canon PR Review

Review a PR against the top 20 Tier 2 LLM-enforceable best practices from 35 seminal software engineering books (Code Complete, Clean Code, A Philosophy of Software Design, Refactoring, Release It!, Designing Data-Intensive Applications, etc.). Produces a structured PR comment with four dimension scores (0-5 each), specific violations with line numbers, and an APPROVE / REQUEST_CHANGES / BLOCK decision. Auto-invoke when the user asks to: - "review PR", "canon review", "best practices review", "engineering standards review" - "score this PR", "check this PR against best practices" - Asks about

5 stars 1 forksGit & Code Review Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add npow/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add npow/claude-skills --skill canon-pr-review
Manual install
git clone --depth 1 https://github.com/npow/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/canon-pr-review ~/.claude/skills/canon-pr-review

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Canon PR Review — Top 20 Tier 2 Practices

Scores a PR against 20 LLM-enforceable practices from seminal engineering books, across four
dimensions. Each dimension scored 0-5. Decision: APPROVE (all ≥ 3), REQUEST_CHANGES (any < 3
but none < 1), BLOCK (any < 1 or security violation).

---

## Phase 0: Fetch PR diff and context

```bash
# Auto-detect repo from cwd if not specified
git remote get-url origin 2>/dev/null

# Fetch PR diff (GitHub.com)
gh pr view <NUMBER> --json title,body,additions,deletions,changedFiles,baseRefName,headRefName
gh pr diff <NUMBER>

# OR for GitHub Enterprise
GH_HOST=<GHE_HOST> gh pr view <NUMBER> --repo <ORG/REPO> \
  --json title,body,additions,deletions,changedFiles,baseRefName,headRefName
GH_HOST=<GHE_HOST> gh pr diff <NUMBER> --repo <ORG/REPO>
```

Read the diff carefully. For each dimension below, scan the ENTIRE diff — not just the first file.
If the diff is large (>1000 lines), focus on new code paths, public interfaces, and error handling paths.

---

## The Four Dimensions

### DIMENSION 1: Code Quality (CC-003, CC-005, CC-006, CC-011, CC-021)

**Practices evaluated:**

**CC-003 — Intention-Revealing Names**
- Source: Code Complete (McConnell), Clean Code (Martin), The Elements of Programming Style (Kernighan & Plauger)
Read the full skill on GitHub

Details

Skill name
canon-pr-review
Path
canon-pr-review/SKILL.md
License
Apache-2.0
Repo updated
20 August 2026

FAQ

What does the Canon PR Review skill do?

Review a PR against the top 20 Tier 2 LLM-enforceable best practices from 35 seminal software engineering books (Code Complete, Clean Code, A Philosophy of Software Design, Refactoring, Release It!, Designing Data-Intensive Applications, etc.). Produces a structured PR comment with four dimension scores (0-5 each), specific violations with line numbers, and an APPROVE / REQUEST_CHANGES / BLOCK decision. Auto-invoke when the user asks to: - "review PR", "canon review", "best practices review", "engineering standards review" - "score this PR", "check this PR against best practices" - Asks about

How do I install the Canon PR Review skill?

Claude Code plugin: /plugin marketplace add npow/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Canon PR Review popular?

It lives in npow/claude-skills, which has 5 GitHub stars and 1 forks.

Related skills

Autopilot

5

npow/claude-skills

Use when the user says "autopilot", "build this", "make it", "ship it", "just do it", "do it", "implement this", or gives a vague idea, spec, task list, or bug fix and expects autonomous execution. Handles decomposition, agent coordination, and verification automatically. "build me end to end", "go from idea to code", "do everything", "run this autonomously". Follows the Spec-Driven Development workflow: specify → clarify → plan → tasks → analyze → implement.

Productivity & Notes

Build Python Library

5

npow/claude-skills

Implements pip-installable Python libraries from scratch using src layout, pyproject.toml, and pytest. Use when the user asks to build, create, implement, or scaffold a Python library, package, pip package, middleware, SDK, or wrapper. Covers project scaffolding, proxy/wrapper patterns, provider-agnostic interfaces, async/sync support, and test infrastructure.

Software Development

Canon Design Review

5

npow/claude-skills

Architecture-level design review evaluating 15 Tier 2 best practices drawn from DDD (Evans), POEAA (Fowler), Release It! (Nygard), DDIA (Kleppmann), Team Topologies (Skelton/Pais), How Buildings Learn (Brand), and Systemantics (Gall). Auto-invoke when a PR touches: - Service definitions, infrastructure code, API boundaries, or database schemas - Files matching **/architecture*, **/design*, **/api/*, **/schema*, **/migrations/* - Any directory named services/, infrastructure/, platform/, domain/, core/ Also invoke when the user says: - "design review", "architecture review", "review the design"

Software Development

Canon Review

5

npow/claude-skills

Unified engineering standards review combining code-level review (canon-pr-review) and architecture-level design review (canon-design-review). Evaluates 35 Tier 2 best practices drawn from 35 seminal engineering books. Auto-invoke when the user asks to: - "canon review", "full review", "engineering review", "review PR" - "review code and architecture", "check against best practices" - "score this PR", "run canon review" Supports three modes: 1. Code Review (20 practices: Code Quality, Module Design, Reliability, Maintainability) 2. Design Review (15 practices: Structural Integrity, Resilience,

Git & Code Review

Edu Lesson Plan

5

eshmith7/claude-skills-library

Plan a lesson backwards from the check, with misconceptions named, whole-class checks that each carry a branch, and what to cut decided in advance. Use for lesson or unit plans.

Git & Code Review

Init Github Repo

5

npow/claude-skills

Initializes a Git repository with a complete GitHub presence — JTBD-focused README with badges, CI/CD workflow, license, .gitignore, and SEO-optimized repo description and topics. Use when the user asks to initialize a repo, set up GitHub, create a readme, push to GitHub, set up CI/CD, or prepare a project for open source.

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.