health

Integrate code quality tools to compute a composite health score.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/az9713/paperclip-gstack-company --skill health-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/az9713/paperclip-gstack-company/tree/main/gstack/health
Command: npx skills add https://github.com/az9713/paperclip-gstack-company --skill health-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typescript, eslint, pytest, knip, shellcheck, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a rapid overview of a codebase's health by performing a series of code quality checks and presenting a composite score.

Core Features & Use Cases

  • Code Quality Score: Calculates a 0-10 score based on type safety, lint cleanliness, test coverage, dead code, and script hygiene.
  • Tool Integration: Incorporates type checkers, linters, test runners, dead code detectors, and shell linters.
  • Trend Tracking: Helps track the quality trend over time for better codebase maintenance.

Quick Start

Run /health to assess the current health of your codebase.

Frequently Asked Questions about health

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

FAQPage Schema
How do I run a codebase health check to calculate a code quality score?

Run a codebase health check by executing a single command to calculate a composite 0-10 quality score. This score integrates results from type safety, lint cleanliness, test coverage, dead code detection, and script hygiene checks.

What does codebase health assessment include beyond basic linting?

Codebase health assessment includes type checking with TypeScript, linting with ESLint, test coverage via pytest, dead code detection with Knip, and shell script linting using Shellcheck to provide a comprehensive quality overview.

Can I use this code quality evaluation tool for continuous integration workflows?

Yes, you can use this code quality evaluation tool for continuous integration and periodic health checks. It automates quality assessment by running integrated checkers and computing a composite health score suitable for CI pipelines.

How do I track code quality trends over time for repository maintenance?

Track code quality trends over time by running periodic health checks to compute the composite score. Monitoring this 0-10 score helps developers visualize maintenance progress and identify gradual degradation in the codebase.

Do I need TypeScript and ESLint configured to assess my codebase health?

You need TypeScript, ESLint, pytest, Knip, and Shellcheck available in your environment to assess codebase health. The tool integrates these specific dependencies to perform type checking, linting, coverage analysis, and dead code detection.

What is the best way to detect dead code and evaluate script hygiene together?

The best way to detect dead code and evaluate script hygiene together is using an automated health check that integrates Knip for dead code detection and Shellcheck for script linting, combining both into a single composite quality score.