Skills for Real Engineers. Straight from my .agents directory.
brooks-sweep
Agent skill fromhyhmrright/brooks-lint
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.
How to install brooks-sweep
npx skills add hyhmrright/brooks-lint# or add only this skill to Claude Code: copy the folder
skills/brooks-sweep/
# into
~/.claude/skills/brooks-sweep/ (all projects)
.claude/skills/brooks-sweep/ (one project)
1# Brooks-Lint — Full Sweep & Auto-Fix23## Setup45Read in order:671. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs93. `../_shared/decay-risks.md` — production risk symptoms104. `../_shared/test-decay-risks.md` — test risk symptoms115. `sweep-guide.md` (this directory) — the unified scan and fix process1213## Process1415**Scope:** if the user did not specify a project or directory, apply Auto Scope Detection16(`../_shared/common.md`) first.17181. Show the pre-flight consent notice and wait for one-time approval (Step 0 of the guide)192. Enumerate scope and initialize pipeline state (Step 1 of the guide)203. Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, fixing, and verifying (Steps 2–5 of the guide)214. Iterate over modified files and their consumers until a clean round or the cap (Step 6 of the guide)225. Aggregate residual and unresolvable items and output the Full Sweep Report (Steps 7–8 of the guide)2324**Mode line in report:** `Full Sweep`
Excerpt shown under the repository's MIT license.
More skills in brooks-lint
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
