health-check

Audit GitHub repositories across six dimensions and generate a markdown health report.

4|1|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/cacack/my-family --skill health-check-cacack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/cacack/my-family/tree/main/.claude/skills/health-check
Command: npx skills add https://github.com/cacack/my-family --skill health-check-cacack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides engineering leaders a fast, structured, and read-only way to evaluate project health across documentation, architecture, tests, roadmap alignment, technical debt, and coding patterns so risks are identified and prioritized before they compound.

Core Features & Use Cases

  • Parallel subagent audits: Orchestrates six focused checks (doc drift, architectural invariants, test quality, phase alignment, technical debt, pattern consistency) run in parallel and reported individually as PASS/WARN/FAIL.
  • Aggregated reporting: Produces a unified Project Health Report with a summary dashboard, detailed findings per dimension, prioritized recommendations, and highlights of strengths to protect.
  • Use Case: An engineering manager runs this against a GitHub repository to quickly surface documentation drift, missing invariants, test gaps, premature roadmap work, debt hotspots, and pattern inconsistencies for triage.

Quick Start

Run the health-check skill on the repository to produce a unified project health report summarizing all six audit dimensions.

Frequently Asked Questions about health-check

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

FAQPage Schema
How do I audit a GitHub repository for technical debt and project health issues?▼

To audit a GitHub repository for project health, you can run a health-check that orchestrates parallel subagents to evaluate documentation, architecture, tests, and technical debt, aggregating findings into a unified markdown report with prioritized recommendations.

What is a project health audit and what dimensions does it cover?▼

A project health audit assesses codebase wellness across documentation, architectural invariants, testing, roadmap alignment, technical debt, and pattern consistency, generating structured PASS/WARN/FAIL findings to identify and prioritize risks before they compound.

Can I assess documentation drift and test quality without write access to the codebase?▼

Yes, you can assess documentation drift and test quality using read-only repository access, as the health-check launches parallel subagents that safely audit docs, invariants, and tests without modifying the underlying codebase.

What's the best way to prioritize engineering risks and coding pattern inconsistencies?▼

The best way to prioritize engineering risks is to run a parallel audit that aggregates structural findings into a summary dashboard, highlighting debt hotspots and pattern inconsistencies alongside actionable recommendations for triage.

Does project health checking work for identifying premature roadmap work and missing architectural invariants?▼

Yes, project health checking works by auditing phase alignment to detect premature roadmap work and evaluating architectural invariants concurrently, returning structured warnings to help engineering leaders correct course early.