Agent skill · software engineering · sickn33
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.
Why this skill is useful
Adds an executable script for unified analysis and auto-fixing across multiple quality dimensions that the AI cannot generate on its own.
What it needs
Requires brooks-lint installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Brooks-Lint — Full Sweep & Auto-Fix When to Use Use this skill when you need 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... 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/decay-risks.md for production risk symptom definitions 4. Read ../shared/test-decay-risks.md for test risk symptom definitions 5. 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. 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 / noncriticalrounds / fixlog 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 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. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/brooks-sweep--cfb058