skills.rest
cloudvoyant
cloudvoyantOFFICIAL
Explore all skills by this author →
GitHub

doctor

Diagnose and optimize CLAUDE.md style guides by fixing structural issues and reducing token count.

Updated Nov 15, 2025
Search Tags:#documentation#optimization#style guide#maintenance#ai agent#claudemd
One-click install
npx skills add https://github.com/cloudvoyant/claudevoyant --skill doctor-cloudvoyant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/cloudvoyant/claudevoyant/tree/main/plugins/style/skills/doctor
Command: npx skills add https://github.com/cloudvoyant/claudevoyant --skill doctor-cloudvoyant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill diagnoses and fixes structural issues in your CLAUDE.md style guide, ensuring it functions correctly across AI agents, and then optimizes it for brevity and efficiency.

Core Features & Use Cases

  • Structural Diagnosis: Identifies and fixes missing Critical Rules blocks, incorrect context tags, and deprecated patterns.
  • Optimization: Reduces token count by moving verbose explanations to documentation, consolidating redundant rules, and removing low-value advice.
  • Use Case: When your CLAUDE.md becomes too large, is missing key sections, or you suspect it's not being interpreted correctly by AI agents, run the doctor to bring it back to health and efficiency.

Quick Start

Run the doctor skill to diagnose and optimize the CLAUDE.md file.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I fix structural issues in a CLAUDE.md style guide?▼

Reduce CLAUDE.md token count by moving verbose explanations to external documentation, consolidating redundant rules, and removing low-value advice. This optimization streamlines your style guide for better AI agent efficiency.

Why does my CLAUDE.md style guide not work correctly with AI agents?▼

Your CLAUDE.md style guide may fail with AI agents due to missing Critical Rules blocks or incorrect context tags. Diagnosing and repairing these structural issues ensures the file is properly interpreted during agent execution.

What is the best way to optimize a large CLAUDE.md file?▼

Optimize a large CLAUDE.md file by running a diagnostic tool to streamline rules and move detailed content to external documentation. This reduces token count while preserving the functional style guide instructions for AI agents.

Do I need shell utilities to diagnose and optimize CLAUDE.md files?▼

Yes, you need shell utilities and sed to diagnose and optimize CLAUDE.md files. These command-line tools are required for the file manipulation and text analysis needed to fix structural issues and reduce token count.

Can I consolidate redundant rules in my CLAUDE.md style guide?▼

Yes, you can consolidate redundant rules in your CLAUDE.md style guide. The optimization process identifies overlapping instructions, merges them, and moves verbose explanations to external documentation to minimize overall token usage.

Related Skills

Explore More Software Engineering Skills→
realsigridjinrealsigridjin
20

omc-setup

Automates oh-my-codex configuration for local or global use while preserving existing files and folders.

Community
Advanced
SamuelSahaSamuelSaha

Token Optimization

Reduce AI token consumption via shallow skill loading, context pruning, and output compression.

Community
Intermediate
devCharuzudevCharuzu

ui-design-system

Generate design tokens and document components for UI design systems.

Community
Advanced
GeargrindadminGeargrindadmin

bmad-os-diataxis-style-fix

Correct documentation markdown files to comply with Diataxis and BMad Method style rules.

Community
Intermediate