health-check

Validate .claude environment integrity and generate a structured health report.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/brianclaridge/_claude --skill health-check-brianclaridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/brianclaridge/_claude/tree/main/skills/health-check
Command: npx skills add https://github.com/brianclaridge/_claude --skill health-check-brianclaridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate the .claude environment for integrity, completeness, and external tool availability to prevent runtime issues.

Core Features & Use Cases

  • Discover components like agents, commands, skills, and hooks.
  • Validate cross-references between agents, commands, and skills.
  • Generate a structured diagnostic health report.
  • Validate configuration files for YAML/JSON correctness.

Quick Start

Run the health check with the /health command to verify environment readiness.

Frequently Asked Questions about health-check

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

FAQPage Schema
How do I validate my environment integrity and catch configuration issues before runtime?

Environment validation checks your .claude setup for completeness, verifying component discovery, cross-references between agents and skills, and external tool availability. Run the /health command to generate a structured diagnostic report that prevents runtime failures.

What does a health check validate in my .claude configuration?

A health check validates YAML/JSON configuration correctness, discovers agents, commands, skills, and hooks, verifies agent-skill and command-agent references, ensures skill completeness, and confirms external tools are accessible.

Can I use health checks to diagnose missing tools or broken skill references?

Yes. Health checks discover all components and validate their cross-references, identifying missing tools, broken agent-skill links, and incomplete skill definitions before they cause failures during execution.

How do I verify that all my agents and skills are properly wired together?

Run the health check to validate all cross-references between agents, commands, and skills. The structured report identifies any missing or misconfigured connections in your .claude environment.

What's the best way to set up environment diagnostics for my .claude workspace?

Execute the /health command to run environment diagnostics. It performs comprehensive validation of component discovery, configuration file syntax, tool availability, and reference integrity across your entire setup.