CommunityCoding & Developmentgithub.com

CLAUDE.md Doctor

An AI skill that scores your CLAUDE.md file (0–100) based on best practices for using it as runtime configuration, and provides actionable repair suggestions. Zero-dependency Python, also callable within Claude Code by saying "check my CLAUDE.md".

What is CLAUDE.md Doctor?

The CLAUDE.md Doctor skill evaluates a project's CLAUDE.md file against a set of best practices that treat CLAUDE.md as a runtime configuration file, rather than just documentation. It generates a score from 0 to 100, breaking down performance across categories like clarity, actionability, and completeness. The skill is implemented as a zero-dependency Python script, making it portable and easy to run locally. It can be invoked directly within Claude Code by the phrase "check my CLAUDE.md", providing immediate feedback and specific, prioritized repair suggestions to improve the file's effectiveness for AI tools. This skill is particularly useful for developers using Claude Code, Cursor, Codex, or similar AI coding assistants that rely on CLAUDE.md for context and instructions. By improving the CLAUDE.md quality, teams can ensure consistent AI behavior, reduce misunderstandings, and streamline their AI-augmented development workflows.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add huiyonghkw/hekouwang-claude-md-doctor-skill

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does CLAUDE.md Doctor do?

CLAUDE.md Doctor: An AI-powered CLAUDE.md checker that scores your project (0–100) against the best practice of "treating CLAUDE.md as runtime configuration" and provides actionable repair suggestions. Zero-dependency Python, also callable inside Claude Code by saying "check my CLAUDE.md".

Related Skills