agent-document-reviewer

What problem does it solve?

Review and improve AI agent instruction documents (such as AGENTS.md, Claude.md, and other agent instruction formats) to enhance quality, clarity, structure, and actionable guidance for end users and AI agents.

Core Features & Use Cases

• Quantitative analysis: automatically compute metrics like line count, structure, link ratios, and readability to identify quality gaps.
• Redundancy detection and progressive disclosure evaluation to optimize token efficiency and maintainability.
• Actionable improvements: provide concrete recommendations, reorganizations, and split guidance based on findings.
• Use Case: audit AGENTS.md in a repository and receive a prioritized improvement plan with suggested file splits.

Quick Start

Analyze the target agent instruction document (e.g., AGENTS.md) and return a prioritized, actionable improvement plan with suggested progressive disclosure.