About brooks-health
brooks-health is a Brooks-Lint skill that produces a health dashboard for a project. It runs abbreviated scans across four dimensions, calculates weighted per-dimension and composite scores, and formats the results as a dashboard.
Key features
- 01Scans four dimensions
- 02Calculates weighted dimension scores
- 03Computes a composite health score
- 04Generates a health dashboard
Use cases
- 01Getting a project health overview
- 02Comparing dimension scores with the composite score
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ hyhmrright/ brooks-lint --skill brooks-healthAfter installing, type/brooks-healthin Claude Code to confirm it loaded.
Bundled fileshealth-guide.md
Details
From the project READMEBrooks-Lint — Health Dashboard
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 symptomshealth-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.
- Run abbreviated scans across all four dimensions (Step 1 of the guide)
- Compute per-dimension and composite Health Scores with weighting (Step 2 of the guide)
- Output the Health Dashboard using the dashboard report template (Step 3 of the guide)
Mode line in report: Health Dashboard
Comments
Markdown supported