brooks-test
Helps your agent check test quality. It finds issues that can make code fragile or hard to maintain.
What it does
This tool analyzes the quality of your software tests. It checks if tests are brittle, misuse 'mocks' (simulations), have unclear setups, weak checks, take too long to run, and could cause future maintenance issues.
When to use it
- ✓When you want to improve the quality of existing tests.
- ✓Before making major code changes to understand test risks.
- ✓To identify tests that take too long to execute.
Example of what to ask your AI
“Analyze the quality of my software tests and tell me where I can improve.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool reads classic software testing books to understand common problems. It then examines your tests, looks for signs of issues, and generates a report with suggestions.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill brooks-testOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/brooks-test/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Brooks-Lint — Test Quality Review
When to Use
Use this skill when you need 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...
Setup
- Read
../_shared/common.mdfor the Iron Law, Project Config, Report Template, and Health Score rules - Read
../_shared/source-coverage.mdfor book-level coverage, exceptions, and tradeoffs - Read
../_shared/test-decay-risks.mdfor test-space symptom definitions and source attributions - Read
test-guide.mdin this directory for the test quality review framework
Process
If the user has not shared test files or pointed to a test directory: apply Auto
Scope Detection from ../_shared/common.md to determine the review scope before proceeding.
- Build the test suite map (guide's "Before You Start" section)
- Scan for each test decay risk in the order specified (Steps 1–4 of the guide)
- Apply the Iron Law and output using the Report Template (Step 5 of the guide)
Mode line in report: Test Quality Review
Limitations
- Use this skill only when the task clearly matches its upstream source and local project context.
- Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
- Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.
FAQ
What are 'mocks'?
'Mocks' are simulations of other parts of your software used to test an isolated piece. Overuse or incorrect use can make tests brittle.
What does 'brittle tests' mean?
Brittle tests are those that fail easily, even when the main code is working correctly, often because they depend on too many implementation details.
What is 'book coverage'?
Refers to which concepts from specific software engineering books were used to analyze your tests.
Details
Original description by the author
Review test-suite quality using established testing literature; identify brittleness, mock abuse, unclear fixtures, weak assertions, slow feedback, and maintenance risks.
Popularity
- GitHub stars
- 48k
- Ranking position
- #2450
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
cpp-testing
Makes your agent write and improve tests for C++ code. It helps set up testing tools and fix errors.
affaan-m/ECC
csharp-testing
Helps your agent create tests for C# and .NET code. It uses best practices to ensure tests are efficient and reliable.
affaan-m/ECC
django-tdd
Enables your agent to apply testing strategies for Django with pytest-django and TDD. It's useful for writing robust tests and ensuring code quality, especially for DRF APIs.
affaan-m/ECC