Brooks-Lint — Health Dashboard

SkillDev tools

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

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Brooks-Lint skill

What this skill tells your AI

The instructions your AI receives, as published by hyhmrright/brooks-lint in skills/brooks-health/SKILL.md and read by ahel’s review.

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)

Mode line in report: Health Dashboard

Signals

GitHub stars: 2k
Forks: 69
Last commit: Sep 2026

Others that do the same job

brooks-health
Skill · hashgraph-online

Advanced

Item type: skill
Key: brooks-health-hyhmrright
Source: github.com/hyhmrright/brooks-lint

github.com/hyhmrright/brooks-lint