skills-project-health

Diagnose health issues in Claude Code skill collections with tiered checks and reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Health-check Claude Code skill collections (repositories) to ensure universal checks and per-skill validation are applied.

Core Features & Use Cases

  • Run universal checks from project-health
  • Apply skills-specific checks for cross-refs, marketplace integration, and validator infrastructure
  • Produce a combined health report across all SKILL.md directories when invoked

Quick Start

Run the health check across your skill collection with the skills-project-health tool to verify universal and skill-specific checks.

Frequently Asked Questions about skills-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 Claude Code skill collection?

Run a health check by invoking the tool against your repository to apply universal project-health checks and skill-specific validators, generating a combined report across all SKILL.md directories.

What does skill collection validation check for in a repository?

Skill collection validation checks for universal project-health issues and skill-specific problems including cross-refs, dependencies, marketplace integration, and validator infrastructure across all SKILL.md directories.

Do I need a SKILL.md file per skill to use project health checks?

Yes, project health checks require a repository with a SKILL.md file per skill, along with tiered checks and report outputs compatible with the project-health framework.

Can I generate a combined health report across multiple skill directories?

Yes, you can generate a combined health report across multiple skill directories by invoking the tool, which aggregates universal and skill-specific checks into a single framework-compatible output.

What is the best way to validate cross-refs and dependencies in Claude Code skills?

The best way to validate cross-refs and dependencies in Claude Code skills is to use a dedicated skill-specific validator that diagnoses these issues alongside universal project-health checks.

Why does my skill validation report show infrastructure errors?

Skill validation reports show infrastructure errors when the health check detects issues with validator infrastructure, cross-refs, dependencies, or marketplace integration within your SKILL.md directories.