health

Computes a weighted 0-10 composite score from type, lint, test, dead-code, and shell checks.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill health-tumeloramaphosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/gstack/health
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill health-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Health checks are painful when they require juggling multiple tools and manually interpreting results. The health dashboard turns type checking, linting, tests, and dead-code detection into a single 0-10 score and shows how that score trends over time.

Core Features & Use Cases

  • Composite code-quality scoring (0-10): Wraps existing project checks (type checker, linter, test runner, dead code detector, shell linter) and combines them into one weighted health number so you can compare runs.
  • Trend tracking over time: Records health outcomes across invocations to surface improvements and regressions instead of treating each run as isolated.
  • Focused use cases: Use it for code health check requests, “run all checks,” and “how healthy is the codebase” questions when you want a clear go/no-go quality signal.
  • Operational guidance: Provides a consistent workflow for running the full suite of checks and interpreting the dashboard outputs.

Quick Start

Ask your AI to run the health check for the current codebase and return the weighted health score plus any notable regressions or persistent issues.

Frequently Asked Questions about health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I combine multiple static analysis and test runner results into a single code quality score?

To combine static analysis and test results into a code quality score, run your type checker, linter, test runner, dead code detector, and shell linter. The tool aggregates these outputs into a weighted 0-10 composite health score.

What is the best way to track codebase health trends over time instead of isolated runs?

Tracking codebase health trends over time is done by recording the weighted 0-10 composite score from each health check invocation. This history surfaces continuous improvements and regressions rather than evaluating runs in isolation.

How does a dead code and shell lint detection health check work?

A dead code and shell lint detection health check works by invoking existing project tooling for each category. The tool aggregates linting and dead code detection results, applying a weighted calculation to generate an overall 0-10 code quality score.

Can I use this composite code quality scoring without configuring my own type checker and linter?

You cannot use composite code quality scoring without existing tooling because it requires invoking your project's type checker, linter, test runner, dead code detector, and shell linter to compute the weighted 0-10 score.

Why does my codebase get a low overall health score when all my tests pass?

Your codebase health score may be low because the 0-10 composite score is weighted across multiple checks. Failing static analysis, dead code detection, or shell linting issues will lower the overall score even if tests pass.

What do I need to run a full code health check and get a go/no-go quality signal?

To run a full code health check and get a go/no-go quality signal, you need configured type checking, linting, test running, dead code detection, and shell linting tools. The tool executes these checks and returns a weighted composite score.