Claude 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

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download hyhmrright-brooks-lint-skills_brooks-health-17cdd1c.zip · 2 KB

Install

skills CLI npx skills add https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-health
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install hyhmrright-brooks-lint@llmmart
Git git clone https://github.com/hyhmrright/brooks-lint.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole hyhmrright/brooks-lint collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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

Files (brooks-lint)
  • health-guide.md 3.7 KB
    Loading…
  • SKILL.md 1.7 KB
    ---
    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`
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.