mcpbeat Sign in

Brooks Sweep Agent Skill

by hyhmrright

> architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution. Drawing on twelve classic engineering books. issues", "clean up the whole project", or asks for a single command that both diagnoses and remediates quality problems. findings without code changes; single-dimension reviews (use the focused skill checks, HTTP /health endpoints, Kubernetes probes, database health, or application uptime.

4k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1313
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/hyhmrright/brooks-lint --skill brooks-sweep

What comes with it

12 513 bytes besides the instruction
sweep-guide.md

The instruction itself

3 sections, as written by the author

Brooks-Lint — Full Sweep & Auto-Fix

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 — production risk symptoms
  • ../_shared/test-decay-risks.md — test risk symptoms
  • sweep-guide.md (this directory) — the unified scan and fix process

Process

Scope: if the user did not specify a project or directory, apply Auto Scope Detection

(../_shared/common.md) first.

  • Show the pre-flight consent notice and wait for one-time approval (Step 0 of the guide)
  • Enumerate scope and initialize pipeline state (Step 1 of the guide)
  • Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, fixing, and verifying (Steps 2–5 of the guide)
  • Iterate over modified files and their consumers until a clean round or the cap (Step 6 of the guide)
  • Aggregate residual and unresolvable items and output the Full Sweep Report (Steps 7–8 of the guide)

Mode line in report: Full Sweep

How to use it

Copy the folder

Take hyhmrright/brooks-sweep from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.