doc-organizer

Organize documentation using Progressive Disclosure, structuring content into 3–4 hierarchical layers: top-level categories, sub-categories, and documents. This approach drastically reduces token usage while improving navigability and cognitive load for users accessing your knowledge base.

Progressive Disclosure organizes information from high-level overviews to detailed specifics, allowing AI systems to access only necessary context. This technique achieves 95%+ token reduction in context window usage compared to flat documentation structures.

Yes. This Skill restructures documentation by purpose rather than format, reorganizing files into purpose-based categories with consistent naming conventions (plural lowercase hyphenated directories), auto-generated README indices for navigation, and a guided 5-step reorganization workflow.

The Skill generates README index files for each hierarchical section and creates a CLAUDE master index for the entire documentation set. These are produced automatically during the reorganization workflow to establish clear navigation paths through your knowledge base.

Use consistent naming patterns: directories should be plural, lowercase, and hyphenated; files follow defined patterns aligned with your information architecture. These conventions ensure predictability and improve discoverability across your reorganized documentation structure.

Yes. The Skill is designed specifically for large documentation projects with hundreds of documents. It scales Progressive Disclosure principles to create dimensional hierarchies that maintain clarity and navigability regardless of project size.