enhance-docs
Optimizes documentation for both human readability and AI retrieval (RAG readiness) through structural improvements.
Install
mkdir -p .claude/skills/enhance-docs-christophacham && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16365" && unzip -o skill.zip -d .claude/skills/enhance-docs-christophacham && rm skill.zipInstalls to .claude/skills/enhance-docs-christophacham
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when improving documentation structure, accuracy, and RAG readiness.Key capabilities
- →Analyze documentation for readability
- →Validate link integrity
- →Check heading hierarchy and structure
- →Optimize content for token reduction
- →Improve RAG readiness with chunking guidelines
- →Apply auto-fixes for identified issues
How it works
The skill discovers and parses Markdown files, runs pattern checks for links, structure, token efficiency, and RAG optimization, then generates a report and applies auto-fixes if requested.
Inputs & outputs
When to use enhance-docs
- →Optimizing docs for AI agents
- →Fixing broken links in READMEs
- →Structuring documentation for RAG
About enhance-docs
Analyzes Markdown documentation, validates links/structure, and applies fixes to optimize content for token reduction and accurate AI information retrieval.
Use when improving documentation structure, accuracy, and RAG readiness.
Limitations
- →Auto-fix only HIGH certainty issues
- →Preserve original tone and style
- →Balance AI optimization with human readability (default mode)
How it compares
This skill specifically optimizes documentation for AI retrieval and token efficiency while balancing human readability, unlike general documentation linters.
Compared to similar skills
enhance-docs side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| enhance-docs (this skill) | 0 | 7mo | No flags | Intermediate |
| postmortem-writing | 17 | 4mo | No flags | Beginner |
| wiki-page-writer | 5 | 5mo | No flags | Advanced |
| confluence-assistant | 1 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by christophacham
View all by christophacham →You might also like
postmortem-writing
wshobson
Write effective blameless postmortems with root cause analysis, timelines, and action items. Use when conducting incident reviews, writing postmortem documents, or improving incident response processes.
wiki-page-writer
microsoft
Generates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
confluence-assistant
tech-leads-club
Expert in Confluence operations using Atlassian MCP - automatically detects workspace Confluence configuration or prompts for site details. Use for searching, creating, updating pages, managing spaces, and adding comments with proper Markdown formatting.
business-knowledge-workflow
TencentBlueKing
业务知识获取与 Skill 文档编写工作流。当用户需要熟悉新业务模块、从 iWiki 获取文档、结合代码分析生成架构文档、或将业务知识沉淀为 Skill 时使用。
technical-doc-creator
mhattingpete
Create HTML technical documentation with code blocks, API workflows, system architecture diagrams, and syntax highlighting. Use when users request technical documentation, API docs, API references, code examples, or developer documentation.
Outline Open Source Team Knowledge Base and Wiki Platform
agentskillexchange
Outline is a fast, collaborative knowledge base for teams built with React and Node.js. It provides real-time editing, Markdown support, and a rich API for integration with Slack, authentication providers, and custom workflows.