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.

505 tokens
context cost
SKILL.md, read when the skill is used
2
files
plus reference files
0
copies elsewhere
how many repositories repackaged it
1 313
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.