health

Aggregate type checker, linter, test, and coverage results into a normalized health score.

12|6|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/shogo-labs/shogo-ai --skill health-shogo-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/shogo-labs/shogo-ai/tree/main/packages/agent-runtime/templates/virtual-engineering-team/.shogo/skills/gstack-health
Command: npx skills add https://github.com/shogo-labs/shogo-ai --skill health-shogo-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code health dashboards summarize quality signals from your codebase by aggregating results from type checkers, linters, tests, and code-coverage metrics to help you decide where to fix issues.

Core Features & Use Cases

  • Centralized visibility into code health by running type checks, linting, test suites, and dead-code detection.
  • Tracks trends over time and computes a weighted 0-10 health score that you can surface in dashboards or CI.
  • Use cases include onboarding new projects, auditing large codebases, and measuring impact of refactors on quality.

Quick Start

Start the health skill to generate a real-time dashboard showing your code quality.

Frequently Asked Questions about health

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

FAQPage Schema
How do I aggregate code quality metrics like linting errors and test coverage into a dashboard?

A code health dashboard solves this by aggregating linting errors, test coverage, and dead-code detection results into a single normalized score, providing centralized visibility and tracking quality trends over time.

What is a normalized code health score and how is it calculated?

A normalized code health score is a weighted 0-10 metric calculated by aggregating lint errors, test coverage, type check results, and dead code signals to represent overall codebase quality.

Can I measure the impact of refactoring on code quality trends over time?

Yes, you can measure refactoring impact by tracking code health trends over time. The dashboard aggregates metrics like test coverage and lint errors to show quality changes between historical runs.

Does this code health dashboard work with codebases of varying sizes and languages?

Yes, the code health dashboard applies to codebases of varying sizes and languages by integrating with standard tooling to aggregate type checks, linting, test suites, and dead-code detection metrics.

How do I surface code health metrics in CI workflows?

You surface code health metrics in CI workflows by integrating the aggregator with standard pipeline tooling to produce precise, actionable results and a normalized 0-10 health score for automated quality gates.

What is the best way to audit a large codebase for dead code and lint errors?

The best way to audit a large codebase for dead code and lint errors is to run an automated health dashboard that aggregates results from linters and dead-code detection into a normalized, actionable health score.