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
Start a fresh conversation. Replace the highlighted placeholders.
Use brooks-health to assess the overall health of [project or directory] across PR quality, architecture, technical debt, and test quality, and return a unified health score with prioritized findings.
Required inputs
[project or directory]
User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗
SKILL.md
name: brooks-healthdescription: > 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).metadata: opencode/slash: "true"
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 symptoms
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.
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)