Brooks Audit

Brooks Audit is a Quality skill for Claude Code, published by hyhmrright in brooks-lint.

1.4K stars61 forkson hyhmrright/brooks-lintAdded 2026/08/19+6% in starsRepository updated 2026/08/14

agent-skillsai-code-reviewarchitecture-reviewauto-fixclaude-codeclaude-code-pluginclean-architecturecode-healthcode-qualitycode-reviewcode-smellscodex-cli-plugindeepseek-harnessdeveloper-toolsdsh-plugingemini-cli-extensionrefactoringstatic-analysistech-debttest-quality

Install in seconds

Install Brooks Audit

Copy Brooks Audit into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-audit ~/.claude/skills/brooks-audit

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/hyhmrright/brooks-lint.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/brooks-audit/SKILL.md in hyhmrright/brooks-lint
Installs to: ~/.claude/skills/brooks-audit
Collection: One of 9 skills cataloged from this repository
Category: Quality — 1354 skills

What Brooks Audit does

Brooks Audit maps module dependencies, checks layering integrity, and flags structural decay across a codebase, drawing on twelve classic engineering books. Use it for architecture audits or to give new developers a codebase tour.

Brooks Audit is cataloged under Quality on DirSkills. Brooks Audit comes from a repository tagged agent-skills, ai-code-review, architecture-review, auto-fix and claude-code.

Documentation

README

Excerpt

Brooks-Lint — Architecture Audit

Setup

Read in order:

../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
../_shared/decay-risks.md — symptom definitions and source attributions
architecture-guide.md (this directory) — the audit framework

Process

Onboarding mode: If the user asks for an onboarding report, codebase tour, or "explain this codebase to a new developer", read onboarding-guide.md from this directory and follow it instead of architecture-guide.md. This mode explains rather than diagnoses — no Health Score, no Iron Law findings.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Brooks Audit

What else does hyhmrright publish alongside Brooks Audit?
Brooks Audit is one of 9 skills that DirSkills catalogs from hyhmrright/brooks-lint, the repository it ships in. Its siblings there include Brooks Debt, Brooks Harness and Brooks Health. Each one is a separate skill with its own page in this directory, installs the same way Brooks Audit does, and is maintained by hyhmrright in that same repository. The rest of the collection is listed on the hyhmrright/brooks-lint page.
How does Brooks Audit compare to other Quality skills?
Brooks Audit ranks #689 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Brooks Audit against them. Open each page to compare what they document and how they install.