← ClaudeAtlas

config-doctor-litelisted

Quick health-check for AI coding agent configuration. Auto-discovers CLAUDE.md files and skill directories, then runs 3 read-only checks: broken path references in CLAUDE.md, skill folders missing SKILL.md, and weak SKILL.md frontmatter (missing name/description). Python stdlib only, prioritized terminal report, never writes anything. Use when the user asks to audit their Claude Code config, check for broken paths or dead references after moving/renaming a project or migrating machines, or find out why a skill is not loading or triggering. Not for auditing code dependencies (npm/pip), scanning for secrets, linting application configs (nginx, Docker, ESLint, Kubernetes), or creating a new CLAUDE.md from scratch. Memory-index, hooks, and MCP-definition checks plus JSON/CI output are in the full Config Doctor.
guildshelf/free-skills · ★ 0 · AI & Automation · score 57
Install: claude install-skill guildshelf/free-skills
# Config Doctor Lite Health-check your AI coding agent's configuration. Find broken paths in CLAUDE.md, skill folders the agent cannot load, and frontmatter that hurts trigger accuracy — before they silently corrupt your agent's behavior. ## When to use / when not to use **Use this skill when:** - The user asks to audit, health-check, or clean up their Claude Code configuration (CLAUDE.md, skills). - A project folder was **moved or renamed** and references in CLAUDE.md may now point at nothing. - A skill **silently stopped working** — it no longer loads or triggers, and nobody changed the skill itself. - The user migrated to a new machine and wants to verify the config survived. **Do NOT use this skill for:** - Auditing code dependencies (npm audit, pip-audit, cargo audit). - Scanning for secrets or hardcoded credentials (different product). - Linting application configs: nginx, Docker/docker-compose, ESLint, Kubernetes, CI pipelines. - Writing a new CLAUDE.md from scratch (this tool checks existing config; it does not author it). - Checking whether web URLs are alive (only local file paths are verified). ## Quick start Run the scanner first, then talk about the results: ``` python scripts/config_doctor_lite.py ``` The script is **100% read-only**. It never creates, modifies, or deletes anything, so it is always safe to run. Use `--root PATH` (repeatable) for config kept in non-standard locations. ## What gets checked (3 of the full 8) | ID | Check | Sev