Brooks Health

Name: Brooks Health
Author: hyhmrright

ASecurity

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, Ku...

1,504 stars
0 votes
0 copies
3 views
Added May 26, 2026

developmentkubernetesdatabase

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned September 21, 2026

npx -y skills add hyhmrright/brooks-lint --skill brooks-health --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Brooks Health?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/hyhmrright-brooks-health/badge)](https://www.skillsdirectory.com/skills/hyhmrright-brooks-health)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
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`