Brooks Health

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

.agents/skills/_shared

.agents/skills/brooks-audit

.agents/skills/brooks-debt

.agents/skills/brooks-health

.agents/skills/brooks-review

Audit 0.4.1 · source sha 8d83fdc82bd2 · 22 Oct 2026Report an issue or request a re-scan

• Publisherhyhmrright GitHub userOwner of the repository this skill is read from
• Source folderhyhmrright/brooks-lint/skills/brooks-healthThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict8d83fdc82bd2A new audit runs when the source changes
• Repository statusNot archivedLast push 3 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: 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.…

---
name: brooks-health
description: >
  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:

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`

Excerpt, first 1,697 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/hyhmrright/brooks-lint
git -C brooks-lint checkout 8d83fdc82bd2

Works in

1. 2026-10-22
   !CAUTION B 89 / 100

   first audit · source 8d83fdc82bd2

Questions about Brooks Health

• github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-health — the audited source at commit 8d83fdc82bd2 and every finding aboveObserved · 22 Oct 2026

Spotted something wrong? Report a correction · Methodology