Documentation.AI
AI agents can use parts of these docs, but miss or misread a lot of them.
Last scanned Sep 25, 2026documentation.aiDocumentation.AI15 pages tested
This covers the whole site. The documentation seems to live at documentation.ai/docs: scan it for a docs-only score.
Score overview
Documentation.AI scores 78 out of 100 (grade C), passing 15 of 27 checks. 11 still need work. 1 could not be verified.
- Kind of site
- Developer docs
- Checks passed
- 15/27
- Partly passed
- 9
- Failed
- 2
Access
Content discoverability3 passed1 failed2 partly1 unverified
llms.txt links point to Markdown
Same-origin links point to HTML and no markdown alternatives detected (1 external link excluded)
Your llms.txt links point to HTML pages. Update them to .md URL variants so agents receive markdown instead of converted HTML.
Check your fix: Links in llms.txt point at .md URLs, or URLs that return text/markdown.
Pages point agents to llms.txt
llms.txt directive found in HTML of 3 of 15 sampled pages, but buried deep in the page (past 50%)
An llms.txt directive was found in the HTML of some pages but is missing from others, or is buried deep in the page. Ensure the directive appears near the top of every documentation page.
Check your fix:
curl -s https://documentation.ai/ | grep -n llms.txtfinds the link near the top of the HTML.Markdown pages point agents to llms.txt
llms.txt directive found in markdown of 1 of 8 sampled pages, but buried deep in the page (past 50%); 7 had no markdown version
An llms.txt directive was found in the markdown of some pages but is missing from others, or is buried deep in the page. Ensure the directive appears near the top of every markdown page.
Check your fix: The Markdown version of https://documentation.ai/ (its .md URL, or the page fetched with
Accept: text/markdown) has the llms.txt line in its first few lines.llms.txt links work
Not finished: robots.txt asked our scanner not to read some pages this check needed, and we follow it, so it is left out of the score. (All 15 same-origin sampled links resolve (93 total links) (1 external link also failed; may be bot-detection or rate-limiting))
llms.txt exists
llms.txt found at 2 locations; using https://documentation.ai/llms.txt as canonical
llms.txt follows the standard structure
llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
llms.txt fits in an agent's context
llms.txt is 20,947 characters (under 50,000 threshold)
Markdown availability1 failed1 partly
Server returns Markdown when asked
Server ignores Accept: text/markdown header (0/14 sampled pages return markdown)
Your server ignores Accept: text/markdown and returns HTML. Some agents (Claude Code, Cursor, OpenCode) request markdown this way. Configure your server to honor content negotiation.
Check your fix:
curl -sI -H "Accept: text/markdown" https://documentation.ai/returnscontent-type: text/markdown.Pages are available as Markdown
8/14 sampled pages support .md URLs (57%); inconsistent support
0 of 14 pages support .md URLs inconsistently. Ensure all documentation pages serve markdown when .md is appended to the URL.
Check your fix:
curl -sI https://documentation.ai/docs/api-documentation-and-playground/openapi-import.mdreturns 200 with a text/markdown or text/plain content type.
Page size and truncation1 passed3 partly
Markdown pages fit in context
1 of 8 pages between 50K–100K chars (max 57K)
1 of 8 markdown pages are between 50K and 100K characters. These may be truncated on some agent platforms or routed through summarization. Consider splitting large pages.
HTML pages fit in context
3 of 15 sampled pages convert to 50K–100K chars (max 1156K HTML → 64K markdown (88% boilerplate))
3 of 15 pages convert to 50K-100K characters of markdown. Review pages for reducible boilerplate (navigation, serialized tabbed content). Consider providing markdown versions as a smaller alternative path for agents.
Content starts near the top
14 of 15 sampled pages have content starting at 10–50% (worst 43%)
14 of 15 pages have documentation content starting 10-50% into the converted output. Reduce navigation, breadcrumb, and sidebar markup that precedes the content area.
Content is in the HTML without JavaScript
All 15 sampled pages contain server-rendered content
Content structure3 passed
Tabs don't bloat the page
No tabbed content detected across 15 sampled pages
Headings inside tabs name their variant
No tabbed content found; header quality check not applicable
Code blocks are well-formed
All 81 code fences properly closed across 10 pages
URL stability2 passed
Missing pages return a real 404
All 15 sampled pages return proper error codes for bad URLs
Redirects stay on the same host
No redirects detected across 15 sampled pages
Content health1 passed2 partly
llms.txt covers the whole site
llms.txt covers 151/178 sitemap doc pages (85%); 27 missing; 4 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
Your llms.txt covers 85% of your site's pages (80-95% is warn). 27 live pages are not represented in the index.
Markdown matches the HTML page
2 of 8 pages have minor content differences between markdown and HTML
2 pages have minor content differences between their markdown and HTML versions.
Cache headers allow timely updates
All 17 endpoints have appropriate cache headers
Authentication and access1 passed
Gated docs offer another way in
All docs pages are publicly accessible; no alternative access paths needed
Docs are readable without logging in
All 15 sampled pages are publicly accessible
Crawler access1 passed1 partly
Sitemap lists the docs pages
The sitemap at https://documentation.ai/sitemap.xml lists 79 of the 138 docs pages found through llms.txt and page links.
Generate the sitemap from the same source as the docs, so every page is listed. Agents and crawlers use it to find pages that navigation does not link.
Check your fix:
curl -s https://documentation.ai/robots.txt | grep -i sitemapnames a sitemap, and that sitemap lists the pages the report names as missing.Crawlers and AI assistants may read the docs
robots.txt lets Googlebot, Bingbot, OAI-SearchBot, PerplexityBot, Claude-SearchBot and Claude-User read the docs.
Freshness
Maintenance3 passed
Pages say when they were last changed
13 of 14 sampled pages state when they were last changed.
Links and section anchors work
All 33 links and 15 section anchors checked on the sampled pages work. 9 more could not be verified (timeouts or blocked requests) and are not counted.
Sitemap entries still exist
All 10 sitemap entries sampled still exist.
Consistency with the API specNot applicable
Endpoints in the docs exist in the API spec
No OpenAPI description was found, so the docs could not be compared with a spec.
CurrencyNot applicable
Deprecated operations are marked as such
No OpenAPI description was found, so deprecation notices could not be compared with a spec.
Additional checks
MCP server is discoverable
An MCP server answers at https://mcp.documentation.ai/mcp; agents need to sign in to use it.
llms-full.txt is available
No llms-full.txt found at https://documentation.ai/llms-full.txt.
Publish /llms-full.txt with the full text of your docs in Markdown, so an agent can load everything in one request instead of crawling page by page.
Check your fix:
curl -sI https://documentation.ai/llms-full.txtreturns 200.Agent skills are published
No agent skills index was found at /.well-known/agent-skills/index.json.
Publish an Agent Skills index at /.well-known/agent-skills/index.json with a SKILL.md for your main tasks, so agents can load task instructions without reading every page.
About this scan
- Scanned
- Sep 25, 2026
- Pages tested
- 15 of 224 found
- Platform
- Documentation.AI
- Kind of site
- Developer docs
- AFDocs score, on its own
- 75 (C), 11 of 23 checks pass
- Based on 15 sampled pages, chosen deterministically from the sitemap and llms.txt. Pages outside the sample were not read.
- Pages were fetched without running JavaScript, the way most AI agents read the web.
- robots.txt stopped the scanner from reading 5 URLs; checks that needed them are unverified.
- Some checks could not be verified (a timeout, a blocked request or a scan limit); they are left out of the score rather than counted as failures.
- Answerability, where an AI agent answers real questions written from these pages, runs in the open-source scanner with your own API key. This web score is made of Access and Freshness.
Methodology 2026-09.6 · AFDocs 0.20.0
Pages we sampled (15)
- https://documentation.ai/
- https://documentation.ai/blog/document360-vs-documentation-ai
- https://documentation.ai/blog/how-to-write-a-user-manual
- https://documentation.ai/blog/redocly-pricing
- https://documentation.ai/docs
- https://documentation.ai/docs/api-documentation-and-playground/openapi-import
- https://documentation.ai/docs/api-reference/get-branches
- https://documentation.ai/docs/api-reference/post-deploy-preview
- https://documentation.ai/docs/components/expandables
- https://documentation.ai/docs/customize/access-control/password
- https://documentation.ai/docs/customize/site-configuration
- https://documentation.ai/docs/integrations/deployment-webhooks
- https://documentation.ai/docs/integrations/plausible
- https://documentation.ai/docs/sitemap.xml
- https://documentation.ai/legal/terms
Show your score
Add the badge to your docs or README. It updates each time the site is scanned.
Markdown
[](https://documentation.ai/agent-score/documentation-2)HTML
<a href="https://documentation.ai/agent-score/documentation-2"><img src="https://documentation.ai/agent-score/badge/documentation-2.svg" alt="Agent Readiness Score: 78 (C)" height="20"></a>