Skills for Real Engineers. Straight from my .agents directory.
39 skills
brooks-review
Agent skill from
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. Triggers when: user asks to review code, check a PR, shares a diff or pastes code asking "does this look right?" / "any issues here?" / "ready to merge?", or asks for feedback on a function, class, or file. Also triggers when user mentions: code smells / refactoring / clean architecture / DDD / SOLID principles / Hyrum's Law / deep modules / tactical programming / conceptual integrity / Brooks's Law / Mythical Man-Month / second system effect. Do NOT trigger for: questions about how to write code from scratch, language syntax questions, or framework/tool questions where no existing code is shared.
How to install brooks-review
install brooks-review
# install the brooks-lint pack with the skills CLI
npx skills add hyhmrright/brooks-lint# or add only this skill to Claude Code: copy the folder
skills/brooks-review/
# into
~/.claude/skills/brooks-review/ (all projects)
.claude/skills/brooks-review/ (one project)
1# Brooks-Lint — PR Review23## Setup45Read in order:671. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs93. `../_shared/decay-risks.md` — symptom definitions and source attributions104. `../_shared/test-decay-risks.md` — test risk definitions for the Quick Test Check115. `pr-review-guide.md` (this directory) — the analysis process1213## Process1415**Scope:** if the user did not specify files or paste code, apply Auto Scope Detection16(`../_shared/common.md`) first.17181. Understand the review scope, then scan for each decay risk in the order specified (Steps 1–6 of the guide)192. Run the Quick Test Check (Step 7 of the guide) — skip for docs-only or non-production changes203. Apply the Iron Law to every finding214. Output using the Report Template from common.md2223**Mode line in report:** `PR Review`
Excerpt shown under the repository's MIT license.
More skills in brooks-lint
Keep exploring
Similar skill repositories
An agentic skills framework & software development methodology that works.
15 skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
CC1 skill
Public repository for Agent Skills
20 skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
CCCU6 skills
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
CCCXCUGH6 skills