Agent skill
brooks-review
PR code review drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to review code, check a PR, review a pull request, or shares a diff for feedback. Also triggers when user mentions: Brooks's Law / Mythical Man-Month / conceptual integrity / second system effect / code smells / refactoring / clean architecture / DDD / domain-driven design / SOLID principles / Hyrum's Law / deep modules / tactical programming. Use this skill proactively whenever code, a diff, or a PR is shared for review.
Install this agent skill to your Project
npx add-skill https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-review
SKILL.md
Brooks-Lint — PR Review
Setup
- Read
../_shared/common.mdfor the Iron Law, Project Config, Report Template, and Health Score rules - Read
../_shared/source-coverage.mdfor book-level coverage, exceptions, and tradeoffs - Read
../_shared/decay-risks.mdfor symptom definitions and source attributions - Read
pr-review-guide.mdin this directory for the analysis process
Process
- Scan the diff or code for each decay risk in the order specified in the guide
- Apply the Iron Law to every finding
- Output using the Report Template from common.md
Mode line in report: PR Review
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
brooks-audit
Architecture audit drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to audit architecture, review module structure, check system design, or assess project organization. Also triggers when user mentions: clean architecture / dependency inversion / hexagonal architecture / bounded contexts / module coupling / package structure. Use this skill proactively when project structure or module dependencies are discussed.
brooks-test
Test quality review drawing on twelve classic engineering books, with primary focus on xUnit Test Patterns, The Art of Unit Testing, How Google Tests Software, and Working Effectively with Legacy Code. Triggers when: user asks about test quality, flaky tests, mock abuse, test debt, legacy code testability, or shares test files for review. Also triggers when user mentions: test smells / characterization tests / test pyramid / test doubles / over-mocking / brittle tests. Use this skill proactively whenever test files are shared for review.
brooks-debt
Tech debt assessment drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks about tech debt, where to refactor, health check, or systemic maintainability questions. Also triggers when user asks why the codebase is hard to maintain, why adding developers isn't helping, or why complexity keeps growing. Use this skill proactively when maintainability or refactoring priorities are discussed.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
claude-code-expert
Especialista profundo em Claude Code - CLI da Anthropic. Maximiza produtividade com atalhos, hooks, MCPs, configuracoes avancadas, workflows, CLAUDE.md, memoria, sub-agentes, permissoes e integracao com ecossistemas.
lex
Centralized 'Truth Engine' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.
Didn't find tool you were looking for?