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.