**Scan with AI** evaluates the quality of your content automatically and gives every page a score across five dimensions. Instead of relying on gut feel to decid...
**Scan with AI** evaluates the quality of your content automatically and gives every page a score across five dimensions. Instead of relying on gut feel to decid...
Scan with AI evaluates the quality of your content automatically and gives every page a score across five dimensions. Instead of relying on gut feel to decide whether a page is "good enough," you get an objective, actionable read on what's strong and what needs work — before you publish.
How scanning works
Quality analysis runs continuously while you write:
- Automatic — the page is re-scored as you edit, so the Quality badge in the page header always reflects the current draft.
- On demand — open the document insights panel (click the Quality badge, or press <kbd>Ctrl/⌘ Shift .</kbd>) to see the full breakdown and prioritized suggestions.
A scan analyzes the page's content, structure, metadata, and links, then produces a score and a prioritized list of suggestions.
The five dimensions
Each page is scored on five dimensions, which roll up into an overall score using fixed weights:
| Dimension | Weight | What it measures |
|---|---|---|
| **Readability** | 25% | Sentence length, reading level, clarity, active voice, jargon |
| **Structure** | 25% | Heading hierarchy, logical flow, section length, use of blocks |
| **SEO** | 20% | Title and description quality, keyword coverage, metadata completeness |
| **Accessibility** | 15% | Alt text on images and semantic structure |
| **Completeness** | 15% | Topic coverage, presence of examples, missing sections |
The overall rating
The weighted scores combine into a single 0–100 score with a status label:
| Status | Score | Meaning |
|---|---|---|
| **Excellent** | 88–100 | Ready to publish |
| **Good** | 75–87 | Solid; minor improvements available |
| **Fair** | 60–74 | Needs work before publishing |
| **Needs work** | 0–59 | Significant gaps |
Suggestions
A scan doesn't just grade — it tells you how to improve. Each finding is specific and actionable, for example:
- "The introduction is missing — readers don't know who this page is for."
- "Heading levels skip from H2 to H4 in the 'Configuration' section."
- "The meta description is 12 characters; aim for ~100–160 for better search results."
- "This procedure would be clearer as a
<Steps>block." - "An image is missing alt text."
Many findings can be fixed in one click with Improve with AI, directly from the page header.
Raising a page's score
Click the Quality badge in the page header to open the insights panel.
Findings are ordered by impact. Work from the top.
Use Improve with AI for prose and structure (overall or a single area), or edit directly for specific fixes.
The badge re-scores as you edit, so you can confirm the page reached your target.
Project-wide quality
Per-page scores roll up into the project's Docs Health board, where you can see the weakest pages and assign fixes. The AI agent can also run a scheduled QA audit or SEO audit across a project and report new issues automatically.
Scanning from the CLI
If you work docs-as-code, check quality from your terminal with dxb quality (aliases: health, score):
# Score every page in the project (worst first)
dxb quality
# Limit to one space, and only show pages below a threshold
dxb quality --space api-reference --min 80
# Sort options: worst (default), best, title
dxb quality --sort bestSee Search & quality (CLI) for details.