documentation-expert

Audit documentation structure, flow, and navigation to generate improvement plans.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/hvngroup/directus_b2b_crm --skill documentation-expert-hvngroup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-expert
Source: https://github.com/hvngroup/directus_b2b_crm/tree/main/.agent/skills/documentation-expert
Command: npx skills add https://github.com/hvngroup/directus_b2b_crm --skill documentation-expert-hvngroup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation teams often struggle with unclear information architecture, inconsistent terminology, and weak navigational cues, causing poor readability and low discoverability.

Core Features & Use Cases

  • Structured audits: Diagnose document structure, cohesion, audience targeting, and navigation.
  • Architectural templates: Provide hub-and-spoke patterns, Diátaxis-aligned grouping, and consistent terminology guidance.
  • Quality validation: Generate checklists, templates, and quick-start guidance to uplift existing docs.

Quick Start

Audit your documentation and generate a prioritized improvement plan based on structure, flow, and audience.

Frequently Asked Questions about documentation-expert

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

FAQPage Schema
How do I improve documentation structure and navigation for better user experience?

To improve documentation structure and navigation, you can audit your content flow, analyze audience targeting, and apply architectural templates like hub-and-spoke patterns to surface actionable enhancements for discoverability.

What is the best way to audit technical documentation and API references?

The best way to audit technical documentation is to diagnose document cohesion, evaluate information architecture, and use validation checklists to identify readability gaps and weak navigational cues.

How do I use Diátaxis framework grouping to organize a knowledge base?

Diátaxis framework grouping organizes a knowledge base by aligning content into distinct categories, allowing you to apply architectural templates that ensure consistent terminology and logical document flow.

Why does my documentation have low discoverability and poor readability?

Documentation has low discoverability and poor readability when it suffers from unclear information architecture, inconsistent terminology, and weak navigational cues that prevent users from finding answers.

Can I generate a prioritized improvement plan for existing onboarding guides?

Yes, you can generate a prioritized improvement plan for onboarding guides by running a structured audit to evaluate structure, flow, and audience clarity, then applying quick-start guidance templates.