Optimize Your CLAUDE.md with AI-Powered Doctor Skills

Optimize Your CLAUDE.md with AI-Powered Doctor Skills

This AI agent skill enables precise auditing and optimization of CLAUDE.md and AGENTS.md files by analyzing compliance with official guidelines, identifying outdated or non-functional references, and backtesting implemented rules against historical session data. The tool generates a detailed HTML report with cited evidence and suggested improvements, useful for maintaining up-to-date and functional AI instruction files.

What this skill does

• Conducts a comprehensive checkup of agent-instruction files within the repository.
• Compares file size and adherence to official guidelines.
• Identifies dead references, commands, and outdated claims within the documentation.
• Backtests each rule in CLAUDE.md against historical Claude Code session data.
• Produces a doctor-style HTML report with evidence-cited prescriptions for optimization.

Who it is for

• Developers utilizing Claude Code, Cursor, or Codex AI agents.
• DevOps teams seeking to maintain optimal AI agent performance.
• Documentation specialists needing comprehensive file compliance checks.

Use cases

• Conducting periodic audits of AI agent instruction files to ensure rules are followed and effective.
• Updating stale or non-functional documentation based on evidence from real usage data.
• Providing detailed assessments and recommendations to improve AI agent efficiency and performance.

Technical details

This skill leverages the CLAUDE.md Doctor toolset, executing scripts defined in the repository's 'SCRIPTS' directory to perform deterministic checks. It requires Python 3.9 or higher for operation. The analysis tasks are conducted within the repository or specified directories, ensuring minimal disruption to user environments.

Source & Licence

This package is built on open-source work published by agent-clinic (agent-clinic/claude-md-doctor) and distributed under MIT. The original licence text and copyright notice are included in your download.

Personal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.

Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.

Delivery & Support

• Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
• Format: ZIP archive containing the skill files, documentation and the original licence.
• Support: support@mcpcart.com — we aim to reply within 2 business days.
• Updates: updates are included only where stated on this page.

Refunds

This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.

Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.