docs-optimizer

What problem does it solve?

The Skill optimizes documentation directories to help AI agents navigate content with fewer tool calls, faster discovery, and clearer entry points.

Core Features & Use Cases

• Entry point clarity: Ensure README.md is the obvious starting point for a documentation directory.
• File discoverability: Minimize the number of Read/Grep/Glob operations needed to locate relevant information.
• Navigation friction reduction: Reduce dead ends and unnecessary context switching during navigation.
• Cross-linking: Introduce meaningful internal links to improve topic traversal.
• Scope signaling: Explicitly identify what is not covered to help agents recognize boundaries quickly.

Quick Start

Inspect the target documentation directory, identify the README.md, main entry points, and potential cross-links. Propose and implement structural improvements, merge navigation artifacts, commit changes, and run reviewer subagents to synthesize results.