brooks-lint
Reviews code based on 12 classic engineering books to identify design and architectural risks.
Install
mkdir -p .claude/skills/brooks-lint && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19250" && unzip -o skill.zip -d .claude/skills/brooks-lint && rm skill.zipInstalls to .claude/skills/brooks-lint
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.Key capabilities
- →Identify design smells and architectural risks
- →Analyze coupling and missing abstraction layers
- →Critique naming conventions based on Clean Code principles
- →Check for data consistency and fault tolerance gaps
- →Flag missing stability patterns like timeouts and circuit breakers
How it works
It reviews code by applying principles from classic software engineering books as a lens. This identifies design smells, coupling issues, and architectural risks that typical linters might miss.
Inputs & outputs
When to use brooks-lint
- →Code reviewing
- →Identifying design smells
- →Refactoring legacy code
About brooks-lint
Synthesizes principles from landmark engineering books (e.g., Clean Code, Pragmatic Programmer) to provide feedback on conceptual design smells.
AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.
When not to use it
- →When only checking style rules or syntax
- →When the task is not related to design review or architectural analysis
- →When human design review for production-critical decisions is to be replaced
Limitations
- →Results reflect principles of 12 source books and may not apply to all architectural styles or domains
- →Should complement, not replace, human design review for production-critical decisions
- →Only for design review and architectural analysis
How it compares
This skill provides conceptual design feedback grounded in established engineering principles, which differs from standard linters that focus on stylistic or syntactic issues.
Compared to similar skills
brooks-lint side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| brooks-lint (this skill) | 0 | 3mo | Review | Advanced |
| solid-principles | 57 | 12mo | No flags | Intermediate |
| python-design-patterns | 19 | 5mo | No flags | Intermediate |
| modular-code | 4 | 9mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by ARareUsername
View all by ARareUsername →You might also like
solid-principles
SmidigStorm
Enforce SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion) in object-oriented design. Use when writing or reviewing classes and modules.
python-design-patterns
wshobson
Python design patterns including KISS, Separation of Concerns, Single Responsibility, and composition over inheritance. Use when making architecture decisions, refactoring code structure, or evaluating when abstractions are appropriate.
modular-code
parcadei
Modular Code Organization
component-common-domain-detection
tech-leads-club
Identifies duplicate domain functionality across components and suggests consolidation opportunities. Use when finding common domain logic, detecting duplicate functionality, analyzing shared classes, planning component consolidation, or when the user asks about common components, duplicate code, or domain consolidation.
framework-migration-code-migrate
sickn33
You are a code migration expert specializing in transitioning codebases between frameworks, languages, versions, and platforms. Generate comprehensive migration plans, automated migration scripts, and
framework-migration-legacy-modernize
sickn33
Orchestrate a comprehensive legacy system modernization using the strangler fig pattern, enabling gradual replacement of outdated components while maintaining continuous business operations through ex