project-health

Run universal health checks across code, docs, and configuration.

1|5|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/mdproctor/cc-praxis --skill project-health-mdproctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-health
Source: https://github.com/mdproctor/cc-praxis/tree/main/project-health
Command: npx skills add https://github.com/mdproctor/cc-praxis --skill project-health-mdproctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assesses whether a software project is correct, complete, and consistent by running universal quality checks and routing to type-specific health checks when applicable.

Core Features & Use Cases

  • Runs universal health checks across project artifacts (docs, code, configuration) and automatically chains to a type-specific health skill based on the project type declared in CLAUDE.md.
  • Helps teams identify gaps before release, onboarding, or major changes, ensuring documentation, code, and processes stay aligned.
  • Use case: a new project onboarding learns its health profile and surfaces actionable findings to fix issues before merging.

Quick Start

Run the health check on your repository by invoking the project-health skill in Claude Code.

Frequently Asked Questions about project-health

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

FAQPage Schema
How do I run a health check on my software project to verify correctness and completeness?

Verify project health by running universal checks across code, docs, and configuration, then automatically chaining to type-specific health skills based on the project type declared in CLAUDE.md for actionable findings.

Can I use project health validation for different project types like Java or custom configurations?

Yes, project health validation supports multiple project types by reading the project type declared in CLAUDE.md and automatically routing checks to type-specific health skills for java, blog, custom, or generic project structures.

What does a project health check look for in code and documentation?

A project health check looks for correctness, completeness, and consistency across code, docs, and configuration by applying universal quality checks first, then surfacing actionable findings to fix gaps before release or major changes.

When should I run an end-to-end health check on my repository?

Run an end-to-end health check before release, onboarding, or major changes to ensure documentation, code, and processes stay aligned and to surface actionable findings that fix issues before merging.

Does project health checking require any specific dependencies or environment setup?

Project health checking requires no external dependencies, but needs a CLAUDE.md file in the repository to declare the project type so the universal checks can route to the correct type-specific health validation.