dbt
Last scanned docs.getdbt.com/docsDocusaurus15 pages tested
AI agents can use most of these docs. A few fixes would make them reliable. dbt scores 80 out of 100 (grade B), passing 19 of 26 checks. 7 still need work.
Developer docs
Kind of site
19/26
Checks passed
2
Partly passed
5
Failed
Access
Content discoverability4 passed3 failed
llms.txt fits in an agent's context
llms.txt is 235,627 characters (exceeds 100,000 threshold; will be truncated by most agents)
Your llms.txt is 235,627 characters and will be truncated by all major agent platforms. Split into a root index linking to section-level llms.txt files, each under 50,000 characters.
Check your fix:
curl -s https://docs.getdbt.com/docs/llms.txt | wc -cprints less than 50000.Pages point agents to llms.txt
No llms.txt directive found in HTML of any of 15 sampled pages
No agent-facing directive pointing to llms.txt was detected in the HTML of any tested page. Add a visually-hidden element near the top of each page (e.g., a div with CSS clip-rect) containing a link to your llms.txt. If your site serves markdown versions of pages, mention that in the directive too so agents know to request it.
Check your fix:
curl -s https://docs.getdbt.com/docs/about-dbt-extension | grep -n llms.txtfinds the link near the top of the HTML.Markdown pages point agents to llms.txt
No llms.txt directive found in markdown of any of 15 sampled pages
No llms.txt directive was detected in the markdown of any tested page. Add a blockquote near the top of each markdown page (e.g., "> For the complete documentation index, see [llms.txt](/llms.txt)").
Check your fix: The Markdown version of https://docs.getdbt.com/docs/about-dbt-extension (its .md URL, or the page fetched with
Accept: text/markdown) has the llms.txt line in its first few lines.llms.txt exists
llms.txt found at https://docs.getdbt.com/llms.txt
llms.txt follows the standard structure
llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
llms.txt links work
All 15 same-origin sampled links resolve (1332 total links)
llms.txt links point to Markdown
15/15 same-origin sampled links point to markdown content (100%)
Markdown availability1 passed1 failed
Server returns Markdown when asked
Server ignores Accept: text/markdown header (0/15 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://docs.getdbt.com/docs/about-dbt-extensionreturnscontent-type: text/markdown.Pages are available as Markdown
15/15 sampled pages support .md URLs (100%)
Page size and truncation4 passed
Content is in the HTML without JavaScript
All 15 sampled pages contain server-rendered content
Markdown pages fit in context
All 15 pages under 50K chars (median 10K, max 39K)
HTML pages fit in context
All 15 sampled pages under 50K chars (median 73K HTML → 19K markdown (78% boilerplate))
Content starts near the top
Content starts within first 10% on all 15 sampled pages (median 1%)
Content structure2 passed
Headings inside tabs name their variant
2 page(s) with tabs found, but no section headers inside tab panels to evaluate
Tabs don't bloat the page
3 tab group(s) across 2 of 15 sampled pages; all serialize under 50K chars
Code blocks are well-formed
All 74 code fences properly closed across 16 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 passed1 failed1 partly
Markdown matches the HTML page
9 of 15 pages have substantive content differences between markdown and HTML (avg 24% missing)
9 pages have substantive content differences between markdown and HTML (avg 24% missing). If unintentional, agents are getting outdated content; regenerate markdown from source or fix the build pipeline.
Cache headers allow timely updates
16 of 16 endpoints have moderate cache lifetimes (1–24 hours)
16 endpoints have moderate cache lifetimes (1-24 hours). Updates to llms.txt or markdown content may take hours to propagate. Consider reducing cache lifetimes for these resources.
llms.txt covers the whole site
llms.txt covers 100% of 480 sitemap doc pages; 9 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
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 access2 passed
Crawlers and AI assistants may read the docs
robots.txt lets Googlebot, Bingbot, OAI-SearchBot, PerplexityBot, Claude-SearchBot and Claude-User read the docs.
Sitemap lists the docs pages
The sitemap at https://docs.getdbt.com/sitemap.xml lists 489 of the 489 docs pages found through llms.txt and page links.
Freshness
Maintenance2 passed1 partly
Links and section anchors work
1 of 56 references checked on the sampled pages are broken: 0 links and 1 section anchor. 4 more could not be verified (timeouts or blocked requests) and are not counted.
Fix or remove the broken links, redirect moved pages to their new address, and restore or retarget section anchors. Agents follow links to gather context, and a dead link ends that path.
Check your fix: Every link on https://docs.getdbt.com/docs/build/iceberg/adapters/bigquery-iceberg-support#__docusaurus_skipToContent_fallback (no such section) linked from https://docs.getdbt.com/docs/build/iceberg/adapters/bigquery-iceberg-support returns 200, and every
#sectionlink points at an element with that id.Pages say when they were last changed
15 of 15 sampled pages state when they were last changed.
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
Not part of the score: optional extras that help agents use your docs.
MCP server is discoverable
No MCP server was found for these docs.
Offer a read-only MCP server with a search tool over your docs, and link it from llms.txt, so agents in Cursor, Claude and ChatGPT can query your docs directly.
llms-full.txt is available
llms-full.txt found at https://docs.getdbt.com/llms-full.txt (over 2 MB).
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
- Oct 21, 2026
- Pages tested
- 15 of 489 found
- Platform
- Docusaurus
- Kind of site
- Developer docs
- AFDocs score, on its own
- 77 (C), 15 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 1 URL; checks that needed them are unverified.
- 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://docs.getdbt.com/docs/about-dbt-extension
- https://docs.getdbt.com/docs/build/iceberg/adapters/bigquery-iceberg-support
- https://docs.getdbt.com/docs/build/snapshots
- https://docs.getdbt.com/docs/dbt-ai/pricing-billing/trial-and-billing
- https://docs.getdbt.com/docs/dbt-apis/discovery-schema-environment-applied-exposures
- https://docs.getdbt.com/docs/dbt-apis/sl-jdbc
- https://docs.getdbt.com/docs/dbt/about-dbt-install
- https://docs.getdbt.com/docs/deploy/job-scheduler
- https://docs.getdbt.com/docs/explore/project-recommendations
- https://docs.getdbt.com/docs/local/connect-data-platform/greenplum-setup
- https://docs.getdbt.com/docs/local/connect-data-platform/watsonx-spark-setup
- https://docs.getdbt.com/docs/platform/about-platform/architecture
- https://docs.getdbt.com/docs/platform/connect-data-platform/connect-snowflake
- https://docs.getdbt.com/docs/platform/manage-access/scim-okta
- https://docs.getdbt.com/docs/platform/secure/private-connectivity/azure/azure-synapse
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/getdbt)HTML
<a href="https://documentation.ai/agent-score/getdbt"><img src="https://documentation.ai/agent-score/badge/getdbt.svg" alt="Agent Readiness Score: 80 (B)" height="20"></a>Agent-ready docs by default
Live in under 5 min · No credit card required