claude-md-optimizer

Extract and rewrite oversized CLAUDE.md files into sub-documents with progressive disclosure.

21|5|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/wrsmith108/claude-md-optimizer --skill claude-md-optimizer-wrsmith108
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-optimizer
Source: https://github.com/wrsmith108/claude-md-optimizer/tree/main
Command: npx skills add https://github.com/wrsmith108/claude-md-optimizer --skill claude-md-optimizer-wrsmith108

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Oversized CLAUDE.md files waste cognitive load and context window budget; claude-md-optimizer compresses inline content using progressive disclosure while preserving 100% information fidelity.

Core Features & Use Cases

  • Analyze CLAUDE.md to categorize sections into Essential, Reference, and Redundant.
  • Detect encryption constraints and plan safe sub-document extraction.
  • Rewrite the main CLAUDE.md with a Sub-Documentation Table and progressive-disclosure links; generate and populate sub-documents verbatim.
  • Validate that there is zero information loss and maintain essential content inline; ensure CI and encryption constraints remain compliant.

Quick Start

Trigger the optimization by saying 'optimize CLAUDE.md'.

Frequently Asked Questions about claude-md-optimizer

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

FAQPage Schema
How do I shrink an oversized CLAUDE.md file without losing context?

To shrink an oversized CLAUDE.md file without losing context, apply progressive disclosure to categorize sections, extract reference content into verbatim sub-documents, and rewrite the main file with navigation links. This ensures zero information loss while reducing inline cognitive load.

What is progressive disclosure for CLAUDE.md files?

Progressive disclosure for CLAUDE.md files is an optimization technique that reduces inline content by moving reference sections into external sub-documents. Essential rules stay inline while detailed information is linked through a Sub-Documentation Table, preserving full information fidelity.

Can I optimize a CLAUDE.md file that contains encryption constraints?

Yes, you can optimize a CLAUDE.md file with encryption constraints. The optimization process detects encryption requirements and plans safe sub-document extraction, ensuring extracted content remains verbatim and compliant with CI and encryption safety rules.

How do I reduce CLAUDE.md context window usage while keeping all project rules?

Reduce CLAUDE.md context window usage by categorizing sections into Essential, Reference, and Redundant groups. Essential rules stay inline while reference content moves to generated sub-documents, validated to ensure zero information loss and full CI-compatibility.

Does optimizing CLAUDE.md documentation affect CI pipeline compatibility?

No, optimizing CLAUDE.md documentation does not negatively affect CI pipeline compatibility. The process ensures extracted content remains verbatim and essential rules stay inline, satisfying CI-compatibility and zero-loss validation constraints throughout the sub-document extraction.

When should I use progressive disclosure on my CLAUDE.md?

Use progressive disclosure on your CLAUDE.md when the document becomes oversized and wastes cognitive load or context window budget. It allows you to compress inline content while preserving 100% information fidelity by moving reference material to linked sub-documents.