Skills for Real Engineers. Straight from my .agents directory.
brooks-test
Agent skill fromhyhmrright/brooks-lint
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 — that diagnoses structural problems in an existing test suite: brittleness, mock abuse, coverage illusions, slow execution, poor readability. Triggers when: user asks about test quality, shares test files for review, or expresses frustration: "tests keep breaking whenever I change anything", "our tests take forever", "tests pass but bugs still reach production", or "we have too many mocks". Do NOT trigger for: writing new tests from scratch (use the regular test-writing workflow) or testing framework/syntax questions — this skill reviews an existing suite for structural quality problems, not individual test authoring.
How to install brooks-test
npx skills add hyhmrright/brooks-lint# or add only this skill to Claude Code: copy the folder
skills/brooks-test/
# into
~/.claude/skills/brooks-test/ (all projects)
.claude/skills/brooks-test/ (one project)
1# Brooks-Lint — Test Quality Review23## Setup45Read in order:671. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs93. `../_shared/test-decay-risks.md` — test-space symptom definitions and sources104. `test-guide.md` (this directory) — the test quality review framework1112## Process1314**Scope:** if the user did not share test files or point to a test directory, apply Auto15Scope Detection (`../_shared/common.md`) first.16171. Build the test suite map (guide's "Before You Start" section)182. Scan for each test decay risk in the order specified (Steps 1–4 of the guide)193. Apply the Iron Law and output using the Report Template (Step 5 of the guide)2021**Mode line in report:** `Test Quality Review`
Excerpt shown under the repository's MIT license.
More skills in brooks-lint
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
