Document Refactor & Simplify

•
164
•

Refactors and simplifies technical documentation by condensing text into tables and visualizing processes with sequence diagrams.

The doc-refactor skill is a specialized utility designed to maintain lean and readable project documentation by streamlining long-form text without sacrificing essential information. It automatically identifies redundancies, converts complex procedural steps into Mermaid sequence diagrams, and transforms wordy paragraphs into structured tables. This skill is particularly useful for developers who need to keep documentation like CLAUDE.md and internal rule files concise to optimize AI context window usage and improve overall project maintainability.

Key Features

01Converts step-by-step instructions into Mermaid sequence diagrams
02Provides a summary report of line count reduction and changes made
03Transforms long paragraphs into easy-to-read structured tables
04Enforces specific line-count targets for core project documents
05Identifies and eliminates redundant information across files
06164 GitHub stars

Use Cases

01Condensing an oversized CLAUDE.md file to meet brevity standards
02Optimizing project rule files to reduce noise in AI agent prompts
03Visualizing complex logic flows in technical specifications or guides