health

Aggregate type checking, linting, tests, and dead code detection into a weighted 0-10 health score.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/jonkiky/ccdi-federation-ai --skill health-jonkiky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/jonkiky/ccdi-federation-ai/tree/main/.agents/health
Command: npx skills add https://github.com/jonkiky/ccdi-federation-ai --skill health-jonkiky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code health often hides in noisy metrics across type checks, linters, tests, and code-quality signals. This Skill provides a single, interpretable health score that helps teams understand the current state of their codebase and prioritize improvements.

Core Features & Use Cases

  • Wraps existing project tools (type checker, linter, test runner, dead code detector, shell linter) to compute a weighted 0-10 health score.
  • Tracks health trends over time so teams can see improvements or regressions.
  • Produces a concise health report suitable for dashboards and alerts, enabling quick decision making.

Quick Start

Run the health skill to generate a 0-10 weighted 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 health across multiple repositories with a single score?

Code health tracking works by wrapping your existing type checker, linter, test runner, and dead code detector to compute a weighted 0-10 score. This interpretable metric helps teams understand their codebase state and prioritize actionable improvements.

How do I aggregate lint, type-check, and test results into a dashboard metric?

Aggregating lint and test results into a dashboard metric requires a tool that wraps your existing type checker, linter, and test runner to produce a weighted 0-10 health score. The resulting concise report is suitable for dashboards and alerts.

Do I need to install specific linters or test runners to generate a code health score?

Yes, you need the underlying tools like a type checker, linter, test runner, and dead code detector already present in your environment. The skill wraps these existing project tools to compute the weighted health score rather than providing the linters itself.

What's the best way to monitor code quality trends over time?

The best way to monitor code quality trends is to regularly run this skill to generate a weighted 0-10 health score. It tracks health trends over time by aggregating type checking, linting, and test results so teams can see improvements or regressions.

Can I use this code health score for alerts when quality regresses?

Yes, the skill produces a concise health report suitable for dashboards and alerts. By tracking the weighted 0-10 health score over time, you can trigger alerts when type checking, linting, or test metrics indicate a regression in code health.

What code quality checks are included in a weighted health score?

A weighted health score includes type checking, linting, test runs, dead code detection, and shell linting. These existing project tools are aggregated to produce the 0-10 code health score and identify actionable improvements over time.