Chealth

Skill danielithomas/chealth/skills/chealth

A Claude Code Health Check Skill based on best practice

Install

npx -y skills add danielithomas/chealth --skill chealth

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Check CLAUDE.md health against Anthropic best practices — runs deterministic CLI checks then semantic analysis

SKILL.md

2.0 KB, as published. Nobody here has run it

/chealth — CLAUDE.md Health Check

You are performing a comprehensive health check on this project's CLAUDE.md files. Follow these steps exactly.

Step 1: Run deterministic checks

Run the chealth CLI to get structured findings:

uv run --project "${CLAUDE_PLUGIN_ROOT}" chealth --exit-zero --format json . 2>&1

If the CLI is not installed, tell the user:

chealth plugin not available. Reinstall with: claude plugin add chealth

Parse the JSON output. Note all WARN and DANGER findings.

Step 2: Read all discovered CLAUDE.md files

From the CLI JSON output, read every file listed in the file-discovery result's details.files array. Also read any .claude/rules/*.md files and files referenced by @import paths.

Step 3: Perform semantic checks

Using the best practices in ${CLAUDE_SKILL_DIR}/reference.md as your reference, evaluate:

Contradiction detection — Identify rules that conflict with each other, including across files (Rule 11)
Vague instruction assessment — Evaluate whether instructions are concrete enough to verify (Rule 9)
Instruction effectiveness — Judge whether Claude would actually follow each instruction (Rule 18)
Scope appropriateness — Determine if content belongs in root vs subdirectory vs .claude/rules/ (Rules 2, 15, 20)

Step 4: Present unified report

Combine deterministic and semantic findings into a single report using this format:

## CLAUDE.md Health Report

### Deterministic Checks (chealth CLI)
[For each finding:]
- [PASS|WARN|DANGER] **check-name**: message [Rule N]

### Semantic Analysis
[For each finding:]
- [PASS|WARN|DANGER] **check-name**: description

### Summary
- X checks passed, Y warnings, Z dangers
- [Top recommendation if any WARN/DANGER found]

Use PASS/WARN/DANGER severity levels consistently. Semantic findings are advisory — label them as such.