Skills for Real Engineers. Straight from my .agents directory.
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
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)
1# Brooks-Lint — Health Dashboard23## Setup45Read in order:671. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs93. `../_shared/decay-risks.md` — production risk symptoms104. `../_shared/test-decay-risks.md` — test risk symptoms115. `health-guide.md` (this directory) — the dashboard orchestration process1213## Process1415**Scope:** if the user did not specify a project or directory, apply Auto Scope Detection16(`../_shared/common.md`) first.17181. 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)2122**Mode line in report:** `Health Dashboard`
Excerpt shown under the repository's MIT license.
More skills in brooks-lint
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
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
