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 the user specifically requests only one dimension — use the corresponding focused skill instead (brooks-review / brooks-audit / brooks-debt / brooks-test).
How do I install this agent skill?
npx skills add https://github.com/hyhmrright/brooks-lint --skill brooks-healthIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a codebase health dashboard by analyzing project quality across PRs, architecture, technical debt, and testing. It operates as a read-only analyzer of the local codebase to generate a summary report and Mermaid diagrams without any risky capabilities or external network operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Brooks-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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hyhmrright/brooks-lint/brooks-health">View brooks-health on skillZs</a>