# Chealth

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

- **Type:** Skill
- **Install:** `agentstack add skill-danielithomas-chealth-chealth`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [danielithomas](https://agentstack.voostack.com/s/danielithomas)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [danielithomas](https://github.com/danielithomas)
- **Source:** https://github.com/danielithomas/chealth/tree/main/skills/chealth

## Install

```sh
agentstack add skill-danielithomas-chealth-chealth
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /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:

```bash
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:

1. **Contradiction detection** — Identify rules that conflict with each other, including across files (Rule 11)
2. **Vague instruction assessment** — Evaluate whether instructions are concrete enough to verify (Rule 9)
3. **Instruction effectiveness** — Judge whether Claude would actually follow each instruction (Rule 18)
4. **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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [danielithomas](https://github.com/danielithomas)
- **Source:** [danielithomas/chealth](https://github.com/danielithomas/chealth)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-danielithomas-chealth-chealth
- Seller: https://agentstack.voostack.com/s/danielithomas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.