health

Compute a weighted 0-10 code health score from type checker, linter, test runner, dead code detector, and shell linter.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/sanskarbasnet/fstack --skill health-sanskarbasnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/sanskarbasnet/fstack/tree/main/health
Command: npx skills add https://github.com/sanskarbasnet/fstack --skill health-sanskarbasnet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code health degrades over time as checks are run in isolation; this skill wraps a suite of standard project tools to compute a single, interpretable health score and show trends.

Core Features & Use Cases

  • Weighted 0-10 health score that combines type checker, linter, test runner, dead code detector, and shell linter into a single metric.
  • Trend tracking over time to visualize improvements or regressions across commits and releases.
  • CI-ready insights and guidance for codebase maintenance and process improvements.

Quick Start

Run fstack health to generate a 0-10 health score and trend report for your codebase.

Frequently Asked Questions about health

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

FAQPage Schema
How do I track code quality trends over time across releases?

Code quality trends are tracked by computing a weighted 0-10 health score from standard project tools across commits and releases. This score combines a type checker, linter, test runner, dead code detector, and shell linter to visualize regressions or improvements over time.

Can I integrate static analysis and lint checks into a single CI health score?

Yes, you can integrate static analysis and lint checks into a single CI health score by combining a type checker, linter, test runner, dead code detector, and shell linter. This produces a weighted 0-10 metric ready for CI/CD pipeline integration.

What is a weighted code health score and how does it work?

A weighted code health score is a single 0-10 metric that combines results from a type checker, linter, test runner, dead code detector, and shell linter. It wraps these isolated project tools to provide an interpretable assessment of codebase quality.

Does this code health dashboard work for codebases of various sizes?

Yes, the code health dashboard computes a weighted 0-10 score and applies it to codebases of various sizes. It monitors quality trends over time and generates CI-ready insights to guide maintenance and process improvements.

How do I generate a code health report for my project?

To generate a code health report, run the health command to compute a weighted 0-10 score from your project's type checker, linter, test runner, dead code detector, and shell linter. This outputs a trend report for your codebase.

Why combine dead code detection and test runners into one quality metric?

Combining dead code detection and test runners into one quality metric prevents isolated checks from hiding overall degradation. The weighted 0-10 health score provides an interpretable view of codebase quality and guides CI/CD improvements.