Skip to content
Skillpedia
Testing48k · #2450

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

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-test/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-test/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
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-test

Or 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.md
Technical 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

  1. Read ../_shared/common.md for the Iron Law, Project Config, Report Template, and Health Score rules
  2. Read ../_shared/source-coverage.md for book-level coverage, exceptions, and tradeoffs
  3. Read ../_shared/test-decay-risks.md for test-space symptom definitions and source attributions
  4. Read test-guide.md in 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.

  1. Build the test suite map (guide's "Before You Start" section)
  2. Scan for each test decay risk in the order specified (Steps 1–4 of the guide)
  3. 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.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#2450
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills