Brooks Review

Brooks Review is a Quality skill for Claude Code, published by hyhmrright in brooks-lint.

1.4K stars61 forkson hyhmrright/brooks-lintAdded 2026/08/19+6% in starsRepository updated 2026/08/14

agent-skillsai-code-reviewarchitecture-reviewauto-fixclaude-codeclaude-code-pluginclean-architecturecode-healthcode-qualitycode-reviewcode-smellscodex-cli-plugindeepseek-harnessdeveloper-toolsdsh-plugingemini-cli-extensionrefactoringstatic-analysistech-debttest-quality

Install in seconds

Install Brooks Review

Copy Brooks Review into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-review ~/.claude/skills/brooks-review

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/hyhmrright/brooks-lint.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/brooks-review/SKILL.md in hyhmrright/brooks-lint
Installs to: ~/.claude/skills/brooks-review
Collection: One of 9 skills cataloged from this repository
Category: Quality — 1354 skills

What Brooks Review does

Brooks Review performs PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on twelve classic engineering books. Use it when reviewing a PR, diff, or pasted code for readiness to merge or refactoring feedback.

Brooks Review is cataloged under Quality on DirSkills. Brooks Review comes from a repository tagged agent-skills, ai-code-review, architecture-review, auto-fix and claude-code.

Documentation

README

Excerpt

Brooks-Lint — PR Review

Setup

Read in order:

../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
../_shared/decay-risks.md — symptom definitions and source attributions
pr-review-guide.md (this directory) — the analysis process

Process

Scope: if the user did not specify files or paste code, apply Auto Scope Detection (../_shared/common.md) first.

Understand the review scope, then scan for each decay risk in the order specified (Steps 1–6 of the guide)
Run the Quick Test Check (Step 7 of the guide) — skip for docs-only or non-production changes
Apply the Iron Law to every finding
Output using the Report Template from common.md

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Brooks Review

What else does hyhmrright publish alongside Brooks Review?
Brooks Review is one of 9 skills that DirSkills catalogs from hyhmrright/brooks-lint, the repository it ships in. Its siblings there include Brooks Audit, Brooks Debt and Brooks Harness. Each one is a separate skill with its own page in this directory, installs the same way Brooks Review does, and is maintained by hyhmrright in that same repository. The rest of the collection is listed on the hyhmrright/brooks-lint page.
How does Brooks Review compare to other Quality skills?
Brooks Review ranks #692 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Brooks Review against them. Open each page to compare what they document and how they install.