Skill

/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

One skill from brooks-lint.

shell

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

Installs just this skill. Get the whole plugin for auto-invocation.

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/brooks-health

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

Stats

Stars1,248

Forks59

LanguageJavaScript

LicenseMIT

Ships with brooks-lint

SKILL.md

brooks-health.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).
---

# Brooks-Lint — Health Dashboard

## Setup

1. Read `../_shared/common.md` for the Iron Law, Project Config, Report Template, and Health Score rules
2. Read `../_shared/source-coverage.md` for book-level coverage, exceptions, and tradeoffs
3. Read `../_shared/decay-risks.md` for production risk symptom definitions
4. Read `../_shared/test-decay-risks.md` for test risk symptom definitions
5. Read `health-guide.md` in this directory for the dashboard orchestration process

## Process