Tooluck logoTooluck
SKILL.md

brooks-health

Agent skill fromhyhmrright/brooks-lint

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

How to install brooks-health

install brooks-health
# install the brooks-lint pack with the skills CLI
npx skills add hyhmrright/brooks-lint

# or add only this skill to Claude Code: copy the folder

skills/brooks-health/

# into

~/.claude/skills/brooks-health/ (all projects)

.claude/skills/brooks-health/ (one project)

skills/brooks-health/SKILL.md

MITFull file
1# Brooks-Lint — Health Dashboard
2
3## Setup
4
5Read in order:
6
71. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score
82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs
93. `../_shared/decay-risks.md` — production risk symptoms
104. `../_shared/test-decay-risks.md` — test risk symptoms
115. `health-guide.md` (this directory) — the dashboard orchestration process
12
13## Process
14
15**Scope:** if the user did not specify a project or directory, apply Auto Scope Detection
16(`../_shared/common.md`) first.
17
181. Run abbreviated scans across all four dimensions (Step 1 of the guide)
192. Compute per-dimension and composite Health Scores with weighting (Step 2 of the guide)
203. Output the Health Dashboard using the dashboard report template (Step 3 of the guide)
21
22**Mode line in report:** `Health Dashboard`

Excerpt shown under the repository's MIT license.

More skills in brooks-lint

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates