enhance-docs

Analyze documentation structure and readability to produce retrieval-ready guidance.

951|110|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/agent-sh/agentsys --skill enhance-docs-agent-sh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: enhance-docs
Source: https://github.com/agent-sh/agentsys/tree/main/.kiro/skills/enhance-docs
Command: npx skills add https://github.com/agent-sh/agentsys --skill enhance-docs-agent-sh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation quality often suffers from inconsistent structure, vague wording, and weak retrieval signals, making it hard for readers to find information and for AI systems to retrieve relevant content.

Core Features & Use Cases

  • Analyzes documentation structure and readability to identify gaps.
  • Produces RAG-ready guidance and structured recommendations for improving content.
  • Supports multiple doc types (user guides, developer references, knowledge bases) and suggests targeted edits for faster information retrieval.

Quick Start

Run enhance-docs on your project’s docs directory to produce an optimized, retrieval-ready documentation report.

Frequently Asked Questions about enhance-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve documentation readability and retrieval readiness for a knowledge base?

To improve documentation readability and retrieval readiness, analyze your content structure to identify gaps and apply RAG-ready guidance. This produces structured recommendations and targeted edits for faster information retrieval across user guides and developer references.

What makes project documentation ready for retrieval-augmented generation?

Retrieval-augmented generation requires structured output, frontmatter presence, and strong retrieval signals within project documentation. Analyzing content to specify these requirements ensures AI systems can effectively parse and retrieve relevant information from knowledge bases.

How do I optimize a developer reference for structure and retrieval signals?

Optimizing a developer reference involves analyzing its structure and readability to identify gaps. Applying structured recommendations and RAG-ready guidance ensures the content has the necessary frontmatter and formatting for optimal retrieval.

Can I use structured recommendations to fix vague wording in user guides?

Yes, structured recommendations can fix vague wording in user guides by analyzing readability and structure. This process identifies gaps and suggests targeted edits to enhance content clarity and improve retrieval readiness.

Does this approach support multiple languages and documentation formats?

This approach supports multiple languages and varied documentation formats, including user guides, developer references, and knowledge bases. It accommodates these differences to specify requirements for structured output and frontmatter presence across diverse content.

What is the best way to analyze a docs directory for content optimization?

The best way to analyze a docs directory for content optimization is to run an enhancement process that evaluates readability and structure. This produces an optimized, retrieval-ready report with targeted edits for faster information retrieval.