How do I install the Brooks Sweep skill?

Run npx skillmds@latest add concertonotes/brooks-sweep in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Brooks Sweep safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Brooks Sweep?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Brooks Sweep free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Brooks Sweep?

ConcertoNotes (@concertonotes) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Brooks Sweep by concertonotes — Agent Skill

Name: Brooks Sweep
Rating: 4.2 (5 reviews)
Author: ConcertoNotes

Brooks Sweep

Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, 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. Triggers when: user wants to "fix everything", "sweep the codebase", "auto-fix all issues", "clean up the whole project", or asks for a single command that both diagnoses and remediates quality problems. Do NOT trigger for: read-only audits or health reports where the user only wants findings without code changes; single-dimension reviews (use the focused skill instead: brooks-review / brooks-audit / brooks-debt / brooks-test); server health checks, HTTP /health endpoints, Kubernetes probes, database health, or application uptime.

ConcertoNotes Updated Sep 8, 2026 0 repo stars

File contents

Brooks-Lint — Full Sweep & Auto-Fix

Setup

Read ../_shared/common.md for the Iron Law, Project Config, Report Template, and Health Score rules
Read ../_shared/source-coverage.md for book-level coverage, exceptions, and tradeoffs
Read ../_shared/decay-risks.md for production risk symptom definitions
Read ../_shared/test-decay-risks.md for test risk symptom definitions
Read sweep-guide.md in this directory for the unified scan and fix process

Process

If the user has not specified a project or directory: apply Auto Scope Detection from ../_shared/common.md to determine the review scope before proceeding.

Show pre-flight consent notice and wait for the user's one-time approval (Step 0 of the guide)
Enumerate scope and initialize the unresolvable / non_critical_rounds / fix_log state (Step 1 of the guide)
Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, applying Safe + Extended-Safe fixes, and verifying via the project test command (Steps 2–5 of the guide)
Iterate: re-scan modified files + same-module + static consumers; converge on a clean round, retire 3-retry failures to the unresolvable set, cap non-critical rounds at 3 (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

---name: brooks-sweepdescription: Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, 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. Triggers when: user wants to "fix everything", "sweep the codebase", "auto-fix all issues", "clean up the whole project", or asks for a single command that both diagnoses and remediates quality problems. Do NOT trigger for: read-only audits or health reports where the user only wants findings without code changes; single-dimension reviews (use the focused skill instead: brooks-review / brooks-audit / brooks-debt / brooks-test); server health checks, HTTP /health endpoints, Kubernetes probes, database health, or application uptime.---# Brooks-Lint — Full Sweep & Auto-Fix## Setup1. Read `../_shared/common.md` for the Iron Law, Project Config, Report Template, and Health Score rules2. Read `../_shared/source-coverage.md` for book-level coverage, exceptions, and tradeoffs3. Read `../_shared/decay-risks.md` for production risk symptom definitions4. Read `../_shared/test-decay-risks.md` for test risk symptom definitions5. Read `sweep-guide.md` in this directory for the unified scan and fix process## Process**If the user has not specified a project or directory:** apply Auto Scope Detectionfrom `../_shared/common.md` to determine the review scope before proceeding.1. Show pre-flight consent notice and wait for the user's one-time approval (Step 0 of the guide)2. Enumerate scope and initialize the `unresolvable` / `non_critical_rounds` / `fix_log` state (Step 1 of the guide)3. Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, applying Safe + Extended-Safe fixes, and verifying via the project test command (Steps 2–5 of the guide)4. Iterate: re-scan modified files + same-module + static consumers; converge on a clean round, retire 3-retry failures to the `unresolvable` set, cap non-critical rounds at 3 (Step 6 of the guide)5. Aggregate residual and unresolvable items and output the Full Sweep Report (Steps 7–8 of the guide)**Mode line in report:** `Full Sweep`

Frequently asked questions