Agent skill

Brooks Lint

by sickn33 in sickn33/agentic-awesome-skills

AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.

MITAuto-check passedDevelopment

Install Brooks Lint

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brooks-lint .claude/skills/brooks-lint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .claude/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/brooks-lint .agents/skills/brooks-lint && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .agents/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/brooks-lint .cursor/skills/brooks-lint && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .cursor/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/sickn33/agentic-awesome-skills.git --path skills/brooks-lint

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/brooks-lint .gemini/skills/brooks-lint && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .gemini/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/brooks-lint .github/skills/brooks-lint && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .github/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sickn33/agentic-awesome-skills brooks-lint --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/brooks-lint .opencode/skills/brooks-lint && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "brooks-lint" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/brooks-lint into .opencode/skills/brooks-lint/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brooks-lint", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: brooks-lint
GitHub stars: 47k
Used in: 1 other repo
Token cost: ~1.6k tokens
SKILL.md length: 577 words
Files: 1
Skills in repo: 1,497
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.

Works in 6 steps: Smell detection: Flags violations of… → Coupling analysis: Identifies tight… → Naming critique: Applies Clean Code… → …
Tasks that involve Linting and formatting
SKILL.md covers Overview, The 12 Books, When to Use This Skill and How It Works, plus 7 more sections
Calls npx

What it does

Brooks Lint is an agent skill from sickn33/agentic-awesome-skills. AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Linting and formatting, Code review and Refactoring. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

Tasks that involve Linting and formatting
Tasks that involve Code review
Tasks that involve Refactoring

Example prompts

“/brooks-lint”

Requirements

Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Smell detection: Flags violations of DRY, SRP, Law of Demeter, etc.
Coupling analysis: Identifies tight dependencies and missing abstraction layers
Naming critique: Applies Clean Code naming rules to variables, methods, classes
Architecture review: Checks for DDIA-style data consistency and fault tolerance gaps
Stability patterns: Flags missing timeouts, retries, and circuit breakers (Release It!)
Complexity scoring: Applies APOSD complexity metrics to identify over-engineered sections

What it can do on your machine

Read from SKILL.md and the folder at commit b84d35a. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.com
- dev.to
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brooks Lint loads about 1.6k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 577 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~36
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit b84d35a, republished under its MIT licence (© sickn33). 577 words, ~1,584 tokens.

Download SKILL.mdSave it as .claude/skills/brooks-lint/SKILL.md (or your agent's skills folder).

name: brooks-lint
description: AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.
category: development
risk: safe
source: community
source_repo: hyhmrright/brooks-lint
source_type: community
license: MIT
license_source: https://github.com/hyhmrright/brooks-lint/blob/main/LICENSE
date_added: 2026-04-29
author: hyhmrright
tags: code-review, architecture, software-design, refactoring, claude-code

Brooks Lint

Overview

Brooks Lint is a Claude Code skill that reviews your code through the lens of 12 classic software engineering books. Instead of checking style rules, it asks: "What would the authors of The Pragmatic Programmer, Clean Code, and Designing Data-Intensive Applications say about this code?"

It synthesizes the principles from landmark engineering books into actionable, structured feedback — catching design smells, tight coupling, missing abstractions, and architectural risks that linters and AI tools typically miss.

Named after Fred Brooks, author of The Mythical Man-Month — because the hardest bugs are conceptual, not syntactic.

The 12 Books

Book	Key Principles Applied
The Pragmatic Programmer	DRY, orthogonality, tracer bullets
Clean Code	Naming, function size, comment clarity
The Mythical Man-Month	Conceptual integrity, second-system effect
Designing Data-Intensive Applications	Data consistency, fault tolerance, scalability
A Philosophy of Software Design	Deep modules, information hiding, complexity
Refactoring	Code smells, extract method, encapsulation
Working Effectively with Legacy Code	Seams, characterization tests, dependency breaking
Domain-Driven Design	Ubiquitous language, bounded contexts, aggregates
Release It!	Stability patterns, timeouts, bulkheads, circuit breakers
Structure and Interpretation of Computer Programs	Abstraction, recursion, metalinguistic abstraction
The Art of UNIX Programming	Modularity, composability, rule of least surprise
Extreme Programming Explained	YAGNI, simple design, collective ownership

When to Use This Skill

Use when you want architectural feedback beyond what linters provide
Use before major refactors to identify structural debt
Use when reviewing code that "works but feels wrong"
Use when onboarding to a codebase to quickly map risk areas
Use for design reviews before starting a new module or service

How It Works

Brooks Lint applies each book's core principles as a review lens:

Smell detection: Flags violations of DRY, SRP, Law of Demeter, etc.
Coupling analysis: Identifies tight dependencies and missing abstraction layers
Naming critique: Applies Clean Code naming rules to variables, methods, classes
Architecture review: Checks for DDIA-style data consistency and fault tolerance gaps
Stability patterns: Flags missing timeouts, retries, and circuit breakers (Release It!)
Complexity scoring: Applies APOSD complexity metrics to identify over-engineered sections

Installation

bash

# Install via Claude Code plugin marketplace
# Search: "brooks-lint" in Claude Code > Extensions

# Or install via NPX (Antigravity)
npx agentic-awesome-skills --claude
# Then invoke: @brooks-lint

Examples

Example 1: Review a Service Class

@brooks-lint review src/services/PaymentService.ts

Brooks Lint output:

[Pragmatic Programmer] DRY violation: payment validation logic duplicated in 3 places
[Clean Code] Method processPayment() does 4 things — violates Single Responsibility
[Release It!] No timeout on external payment gateway call — risk of cascade failure
[DDIA] No idempotency key — retry on network error will double-charge
[APOSD] PaymentService knows too much about UserRepository — high coupling

Show full SKILL.md (229 more words)Show less

Example 2: Full Codebase Architecture Review

@brooks-lint analyze the overall architecture of this codebase

Example 3: Pre-Refactor Review

@brooks-lint what are the biggest design smells in this module before I refactor it?

Review Categories

Category	Books Applied	What It Catches
DRY / Duplication	PP, Refactoring	Copy-paste code, shared logic not extracted
Naming	Clean Code, DDD	Unclear names, domain language violations
Coupling	APOSD, PP	Tight dependencies, missing interfaces
Stability	Release It!	Missing timeouts, no retry logic, no circuit breakers
Data Integrity	DDIA	Race conditions, non-idempotent operations
Complexity	APOSD, SICP	Over-engineering, unnecessary abstraction
Legacy Debt	WELC	Hard-to-test code, missing seams
Domain Clarity	DDD, XP	Anemic models, missing bounded contexts

Best Practices

Run @brooks-lint after writing new service layers or data pipelines
Combine with @logic-lens for full coverage: logic bugs + design smells
Use @brooks-lint analyze architecture weekly on growing codebases
Focus on CRITICAL and HIGH findings first — LOW findings are style suggestions

@logic-lens — Complementary: catches logic bugs; brooks-lint catches design issues
@security-auditor — Specialized security-only deep scan
@lint-and-validate — Style/syntax linting to run alongside design review

Additional Resources

Limitations

Use this skill only when the task clearly matches the scope described above (design review and architectural analysis). Brooks Lint applies AI-powered analysis grounded in established engineering principles. It should complement — not replace — human design review for production-critical decisions. Results reflect the principles of the 12 source books and may not apply to all architectural styles or domains.

Files

Just SKILL.md in skills/brooks-lint of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit b84d35a

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

lingxling/awesome-skills-cnantigravity-awesome-skills/skills/brooks-lint antigravity-awesome-skills/plugins/agentic-awesome-skills/skills/brooks-lint+1 more

Compare with similar skills

Brooks Lint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brooks Lint compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Brooks Lint this skillsickn33/agentic-awesome-skills	47k	1 repos	~1.6k	Automated safety check: Pass	MIT	yesterday
Rust Best Practicesfarm-fe/farm	5.6k	3 repos	~1.1k	Automated safety check: Pass	MIT	18 days ago
Dignified Python Standardsdocling-project/docling	69k	—	~1.5k	Automated safety check: Pass	Apache-2.0	today
Clean Code GuardamElnagdy/guard-skills	1.3k	2 repos	~4.3k	Automated safety check: Pass	MIT	3 mo ago
Maintainable Code for iPolloWorkDevin-AXIS/iPolloWork	6.8k	—	~2.7k	Automated safety check: Pass	Custom licence	today
Qt Cpp ReviewSerial-Studio/Serial-Studio	7.2k	—	~4.3k	Automated safety check: Pass	Custom licence	today

Similar skills

Rust Best Practices
farm-fe/farm
Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.
5.6k GitHub starsUsed in 3 repos~1.1k tokens
DevelopmentAuto-check passed
Dignified Python Standards
docling-project/docling
Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.
69k GitHub stars~1.5k tokensUpdated today
DevelopmentAuto-check passed
Clean Code Guard
amElnagdy/guard-skills
Reviews generated or changed production code against Clean Code, SOLID, DRY, KISS, YAGNI and LLM-specific failure modes before it ships, in any language.
1.3k GitHub starsUsed in 2 repos~4.3k tokens
DevelopmentAuto-check passed
Maintainable Code for iPolloWork
Devin-AXIS/iPolloWork
A code-change gate for the iPolloWork repository: search and reuse first, keep one source of truth, justify every new file or dependency, and audit the change.
6.8k GitHub stars~2.7k tokensUpdated today
DevelopmentAuto-check passed
Qt Cpp Review
Serial-Studio/Serial-Studio
Qt6/C++ deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.
7.2k GitHub stars~4.3k tokensUpdated today
DevelopmentAuto-check passed
File Good First Bug
BrowserWorks/waterfox-android
A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox.
379 GitHub starsUsed in 2 repos~2k tokens
DevelopmentAuto-check passed

Questions about Brooks Lint

What does Brooks Lint do?

AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks. Brooks Lint is an agent skill from sickn33/agentic-awesome-skills. AI code reviewer grounded in classic software engineering books for catching design smells, coupling issues, and architectural risks.

When should I use Brooks Lint?

Brooks Lint fits situations like: tasks that involve Linting and formatting; tasks that involve Code review; tasks that involve Refactoring.

How do I install Brooks Lint in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a claude-code`. Or copy the skill folder (skills/brooks-lint in sickn33/agentic-awesome-skills) into .claude/skills/brooks-lint in your project. Claude Code loads it when a task matches its description.

How do I install Brooks Lint in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a codex`. Or copy the skill folder (skills/brooks-lint in sickn33/agentic-awesome-skills) into .agents/skills/brooks-lint in your project. Codex loads it when a task matches its description.

Can I use Brooks Lint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill brooks-lint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brooks-lint, .gemini/skills/brooks-lint, .github/skills/brooks-lint and .opencode/skills/brooks-lint in your project.

What does Brooks Lint need to run?

Going by SKILL.md and its folder, Brooks Lint needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Brooks Lint access the network?

SKILL.md names 2 domains. As links in the text: github.com and dev.to. This is read from the text; nothing was executed.

Is Brooks Lint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brooks Lint use?

Brooks Lint is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brooks Lint use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brooks Lint?

Skills that share tags, products or a category with Brooks Lint: Rust Best Practices (farm-fe/farm, 5.6k stars), Dignified Python Standards (docling-project/docling, 69k stars), Clean Code Guard (amElnagdy/guard-skills, 1.3k stars) and Maintainable Code for iPolloWork (Devin-AXIS/iPolloWork, 6.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brooks Lint?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,405 GitHub stars. The repository holds 1,497 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Brooks Lint

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Brooks Lint

Overview

The 12 Books

When to Use This Skill

How It Works

Installation

Examples

Example 1: Review a Service Class

Example 2: Full Codebase Architecture Review

Example 3: Pre-Refactor Review

Review Categories

Best Practices

Related Skills

Additional Resources

Limitations

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from sickn33/agentic-awesome-skills

Related

Questions about Brooks Lint