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.