health

Generate a composite 0-10 code health score from linting, type-checking, testing, and dead-code tools.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill health-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/health
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill health-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects lack a single, easy-to-understand metric that reflects overall code quality, making it hard to track technical debt and improvement over time.

Core Features & Use Cases

  • Toolchain discovery: automatically detects configured linters, type checkers, test runners, and dead‑code detectors in the repository.
  • Weighted scoring: runs each tool, computes individual scores, and combines them into a 0‑10 health index with configurable weights.
  • Trend tracking: stores each run’s results to show progress or regression across CI builds or local checks. Use it when you need a quick health overview before a release, want to monitor quality trends in CI, or want to prioritize fixes based on the composite score.

Quick Start

Ask the health skill to run a full code quality assessment and show the latest score.

Frequently Asked Questions about health

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

FAQPage Schema
How do I calculate a unified code health score for my project?

To calculate a code health score, the skill scans your configured linting, type-checking, testing, and dead-code tools to produce a weighted 0-10 composite index. It requires access to your project's source files and installed quality tools to generate the score.

What is the best way to track code quality trends across CI builds?

Tracking code quality trends involves storing each run's individual and composite health scores to show progress or regression over time. The skill records results from every scan, allowing you to monitor quality trends across CI builds or local checks.

Does the code health score tool automatically detect my configured linters and test runners?

Yes, the code health score tool automatically discovers configured linters, type checkers, test runners, and dead-code detectors in your repository. This toolchain discovery mechanism ensures it runs the appropriate tools to compute individual scores.

Can I configure the weighting of type-checking and test coverage scores in the health index?

Yes, you can configure the weighting of type-checking, linting, test coverage, and dead-code scores in the health index. The skill computes individual scores for each area and combines them into a 0-10 health index using your configurable weights.

Do I need specific quality tools installed to generate a code health assessment?

Yes, you need the relevant quality tools installed and configured in your repository to generate a code health assessment. The skill relies on accessing your project's source files and running the existing configured linters, type checkers, and test runners.

When should I use a composite code quality index instead of individual linter scores?

You should use a composite code quality index when you need a single, easy-to-understand metric to track technical debt or improvement over time. It is ideal for getting a quick health overview before a release or prioritizing fixes based on the combined score.