Working now
What already works.
- Page Size and Truncation Risk is relatively strong at 100/100.
- URL Stability and Redirects is relatively strong at 100/100.
- Authentication and Access is relatively strong at 100/100.
Benchmark report
Docs benchmark report.
Report for
Alchemywww.alchemy.com/docs
This report shows where agents can use these docs cleanly and where the biggest points of friction still are.
Benchmark score
100Grade A+
This report passes 20 of 23 checks, with 2 warnings, 0 failed checks, and 1 skipped checks still shaping the next score lift.
- Checks passed
- 20/23
- Warnings
- 2
- Failed checks
- 0
Key takeaways
What stands out first.
Start with what already works, then move to the fixes most likely to lift the score.
Improve next
What to improve next.
- LLMS TXT Freshness in Observability and Content Health.
- Markdown Content Parity in Observability and Content Health.
Check results
Full score breakdown
Open each category to review the checks behind the score and see exactly where agents still hit friction.
Page Size and Truncation Risk4 passedCan an agent read the page without losing important context?
Page Size and Truncation Risk
4 passed
Can an agent read the page without losing important context?
This area is already one of the stronger parts of the report.
Rendering Strategy
All 10 sampled pages contain server-rendered content
Page Size Markdown
All 10 pages under 50K chars (median 6K, max 33K)
Page Size Html
All 10 sampled pages under 50K chars (median 179K HTML → 10K markdown (95% boilerplate))
Content Start Position
Content starts within first 10% on all 10 sampled pages (median 0%)
Observability and Content Health1 passed2 warningsCan an agent tell whether the docs are fresh and trustworthy?
Observability and Content Health
1 passed2 warnings
Can an agent tell whether the docs are fresh and trustworthy?
2 warnings still need cleanup here.
LLMS TXT Freshness
llms.txt covers 624/668 sitemap doc pages (93%); 44 missing; 88 nested indexes omitted (4826 sitemap pages excluded); 22 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
Markdown Content Parity
3 of 10 pages have minor content differences between markdown and HTML
Cache Header Hygiene
All 12 endpoints have appropriate cache headers
URL Stability and Redirects2 passedCan an agent trust that URLs will stay predictable?
URL Stability and Redirects
2 passed
Can an agent trust that URLs will stay predictable?
This area is already one of the stronger parts of the report.
Http Status Codes
All 10 sampled pages return proper error codes for bad URLs
Redirect Behavior
No redirects detected across 10 sampled pages
Authentication and Access1 passed1 skippedCan an agent access the docs without getting blocked?
Authentication and Access
1 passed1 skipped
Can an agent access the docs without getting blocked?
1 check were skipped in this report.
Auth Gate Detection
All 10 sampled pages are publicly accessible
Auth Alternative Access
All docs pages are publicly accessible; no alternative access paths needed
Content Structure3 passedCan an agent understand how the page is organized?
Content Structure
3 passed
Can an agent understand how the page is organized?
This area is already one of the stronger parts of the report.
Tabbed Content Serialization
No tabbed content detected across 10 sampled pages
Section Header Quality
No tabbed content found; header quality check not applicable
Markdown Code Fence Validity
All 48 code fences properly closed across 12 pages
Markdown Availability2 passedCan an agent fetch a clean text version of the docs?
Markdown Availability
2 passed
Can an agent fetch a clean text version of the docs?
This area is already one of the stronger parts of the report.
Markdown Url Support
10/10 sampled pages support .md URLs (100%)
Content Negotiation
10/10 sampled pages support content negotiation (100%)
Content Discoverability7 passedCan an agent find the right starting point?
Content Discoverability
7 passed
Can an agent find the right starting point?
This area is already one of the stronger parts of the report.
LLMS TXT Exists
llms.txt found at 2 locations; using http://www.alchemy.com/docs/llms.txt as canonical
LLMS TXT Valid
llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
LLMS TXT Size
llms.txt is 495 characters (under 50,000 threshold)
LLMS TXT Links Resolve
All 6 same-origin links resolve (6 total links)
LLMS TXT Links Markdown
6/6 same-origin links point to markdown content (100%)
LLMS TXT Directive (HTML)
llms.txt directive found in HTML of all 10 sampled pages, near the top of content
LLMS TXT Directive (Markdown)
llms.txt directive found in markdown of all 10 sampled pages, near the top of content
Next steps
Get this report in your inbox or track the score over time.
Save the report to a work email now, or tell us what kind of ongoing monitoring would be useful for this docs site.
Built by DocsAlot
Need help improving the score?
DocsAlot helps teams improve help centers, developer docs, API docs, and CLI docs so they are easier for humans to use and easier for agents to read.