brooks-lint

Review code for design smells, coupling issues, and architectural risks.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/Avihusitton/gil-therapy --skill brooks-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brooks-lint
Source: https://github.com/Avihusitton/gil-therapy/tree/main/.agents/skills/brooks-lint
Command: npx skills add https://github.com/Avihusitton/gil-therapy --skill brooks-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standard linters and basic AI code reviewers only catch syntax errors and style violations, missing critical high-level design issues like tight coupling, missing abstractions, and architectural risks that accumulate as technical debt over time. This Skill fills that gap by reviewing code through the lens of 12 classic software engineering books to surface issues that would otherwise go unnoticed until they cause costly refactors or system failures.

Core Features & Use Cases

  • Multi-lens code review: Evaluates code against principles from landmark engineering texts including Clean Code, The Pragmatic Programmer, Designing Data-Intensive Applications, and Domain-Driven Design.
  • Targeted issue detection: Flags design smells, coupling violations, naming inconsistencies, missing stability patterns (timeouts, circuit breakers), and domain model clarity gaps.
  • Use cases: Run before major refactors to identify structural debt, use when onboarding to a new codebase to map high-risk areas, or review code that functions correctly but feels architecturally misaligned.

Quick Start

Use the brooks-lint skill to review the PaymentService.ts file for design smells and coupling issues.

Frequently Asked Questions about brooks-lint

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

FAQPage Schema
How do I detect architectural flaws and design smells in my codebase?

You can identify architectural flaws and design smells by reviewing code against principles from 12 classic software engineering books, targeting high-level coupling violations and structural debt that standard linters miss.

Can I use AI to review code for coupling issues and DRY violations?

Yes, you can use AI to review code for coupling issues and DRY violations by applying principles from texts like Clean Code and Domain-Driven Design to surface architectural risks and domain model clarity gaps.

How do I map high-risk areas when onboarding to a legacy codebase?

When onboarding to a legacy codebase, map high-risk areas by analyzing the code for missing stability patterns, architectural risks, and design smells to highlight structural debt before major refactors.

Does this approach catch missing fault tolerance patterns like circuit breakers and timeouts?

Yes, this approach catches missing fault tolerance patterns by evaluating code against domain-driven design rules and stability patterns, flagging missing circuit breakers and timeouts that could cause system failures.

What is the best way to analyze structural debt before a major refactoring?

The best way to analyze structural debt before refactoring is evaluating the codebase through a multi-lens review using landmark software engineering texts to identify violations of SRP and coupling issues.

How does high-level code review for architecture risks differ from standard linting?

High-level code review for architecture risks differs from standard linting by detecting missing abstractions and domain model clarity gaps, whereas standard tools only catch syntax errors and style violations.