claude-health

Audit the .claude directory for configuration health issues.

187|24|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/sd0xdev/sd0x-dev-flow --skill claude-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-health
Source: https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/claude-health
Command: npx skills add https://github.com/sd0xdev/sd0x-dev-flow --skill claude-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Claude configuration for Claude Code environments can become inconsistent, bloated with junk files, and misaligned skill references, leading to setup drift and fragile projects.

Core Features & Use Cases

  • Health Audit: scans the .claude directory for junk files, missing .gitignore entries, and naming inconsistencies.
  • Consistency & Sync: validates skill references and README counts to keep project structure aligned.
  • Use Case: run during onboarding or maintenance to surface issues and receive actionable fix commands.

Quick Start

Use the claude-health skill to scan your .claude directory and generate a health report.

Frequently Asked Questions about claude-health

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

FAQPage Schema
How do I audit my .claude directory for junk files and configuration drift?

To audit your .claude directory for junk files and configuration drift, run a health-check skill that scans for missing .gitignore entries, naming inconsistencies, and README-sync gaps, then provides actionable fix commands to restore project structure.

What causes configuration drift in a Claude Code project setup?

Configuration drift in a Claude Code project setup is caused by accumulated junk files, missing .gitignore entries, naming inconsistencies across skills, and README counts falling out of sync with actual skill references over time.

How do I check if my Claude skills have naming consistency and README sync issues?

You can check naming consistency and README sync issues by running a configuration audit that validates skill references, compares README counts against registered skills, and surfaces mismatches with actionable fix commands.

Can I use a .claude health-check during initial project onboarding?

Yes, you can use a .claude health-check during initial project onboarding. It applies during both initial setup and ongoing maintenance to surface missing .gitignore entries and cache size issues before they cause setup drift.

What is the best way to fix missing .gitignore entries in a Claude Code environment?

The best way to fix missing .gitignore entries in a Claude Code environment is to run a structured health audit that detects configuration gaps and outputs actionable fix commands to update your .gitignore file directly.