brooks-health
Combined codebase health dashboard that scores a project across all four quality dimensions — PR quality, architecture, tech debt, and test quality — in a single pass, drawing on twelve classic engineering books. Triggers when: user wants an overall quality assessment, asks "how healthy is this codebase?", "run all the checks", "I need a health score before the release", or wants to onboard a new team with a quality overview. Do NOT trigger for: server health checks, HTTP health endpoints, Kubernetes liveness/readiness probes, database health, or application uptime. Also do not trigger when th
npx skills add hyhmrright/brooks-lint --skill brooks-health --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Brooks-Lint — Health Dashboard ## Setup Read in order: 1. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score 2. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs 3. `../_shared/decay-risks.md` — production risk symptoms 4. `../_shared/test-decay-risks.md` — test risk symptoms 5. `health-guide.md` (this directory) — the dashboard orchestration process ## Process **Scope:** if the user did not specify a project or directory, apply Auto Scope Detection (`../_shared/common.md`) first. 1. Run abbreviated scans across all four dimensions (Step 1 of the guide) 2. Compute per-dimension and composite Health Scores with weighting (Step 2 of the guide) 3. Output the Health Dashboard using the dashboard report template (Step 3 of the guide) **Mode line in report:** `Health Dashboard`
- Setup
- Process
What does the brooks-health skill do?
Combined codebase health dashboard that scores a project across all four quality dimensions — PR quality, architecture, tech debt, and test quality — in a single pass, drawing on twelve classic engineering books. Triggers when: user wants an overall quality assessment, asks "how healthy is this codebase?", "run all the checks", "I need a health score before the release", or wants to onboard a new team with a quality overview. Do NOT trigger for: server health checks, HTTP health endpoints, Kubernetes liveness/readiness probes, database health, or application uptime. Also do not trigger when th
How do I install it?
Run `npx skills add hyhmrright/brooks-lint --skill brooks-health --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From hyhmrright/brooks-lint, a repository with 1,284 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.