Is docs.github.com agent ready?
docs.github.com is partly agent ready: it scores 54/100 (grade C) on the w2agent rubric. Weakest areas: Structured Data (21), Agent Protocols (42), Agent Discovery (43), Agent Auth (45).
Changed since last check
No change in score since the previous check (2026-09-15)
Fixed: Semantic HTML elements
Regressed: Response time
Category scores
Technical
86
Agent Auth
45
Agent Discovery
43
Agent Protocols
42
Content Quality
80
Structured Data
21
Bot Accessibility
69
Agent protocol panel
- A2A agent cardNot found
- OAuth discoveryNot found
- MCP discoveryNot found
- llms.txt validityPresent
Check results
Bot Accessibility
- ✓No error status codespass
- ~Response timepartial
- ✗XML sitemap existsfail
- ✓AI agent accesspass
- ✓Edge treatment of agent user-agentstracked, not scoredpass
- ✓robots.txt existspass
- ✓Content negotiation (Markdown)pass
- —Declared AI usage preferencestracked, not scoredskip
Structured Data
- ~OpenGraph meta tagspartial
- ✓Semantic HTML elementspass
- ✗Appropriate Schema.org typefail
- —JSON-LD validskip
- ✓Heading hierarchypass
- ✗Schema.org JSON-LD presentfail
- ✗Schema.org completenessfail
Content Quality
- ✓FAQ contentpass
- ✓Answer-first contentpass
- ✓Content lengthpass
- ✓Token efficiency (HTML-to-text ratio)pass
- ✗Freshness signalsfail
- ✗Author attributionfail
- ✓Citation readinesspass
- ✓Lists and tables for structured infopass
Agent Discovery
- ✓llms.txt follows specpass
- ✓llms.txt existspass
- —MCP server cardtracked, not scoredskip
- ✓Markdown alternate linkspass
- ✗/.well-known/agent-card.jsonfail
- ~llms.txt links resolvepartial
Agent Protocols
- ✓Discoverable API endpointspass
- ✗MCP endpointfail
- ✗Action schemasfail
- —/.well-known/ucpskip
- ✗Structured formsfail
- —WebMCP imperative APItracked, not scoredskip
- —WebMCP declarative APItracked, not scoredskip
- ✓Reachable as Google-Agentpass
- ✓Reachable as ChatGPT-Userpass
- ✓Reachable as Perplexity-Userpass
Agent Auth
- —MCP authorization (401 challenge → protected resource metadata)skip
- ✗PKCE S256 supportfail
- ✓Public API surfacepass
- —Client ID Metadata Documents (bonus)skip
- ✗OpenAPI specificationfail
- ✓Agent/bot auth documentationpass
- ✗OAuth discovery chain (RFC 9728 → RFC 8414)fail
- ✓Developer portalpass
- ~Scoped API permissionspartial
- ✗API catalog (RFC 9727)fail
- —Agent operator signing directorytracked, not scoredskip
Technical
- ✓HTTPSpass
- ✓UTF-8 charsetpass
- ✗Canonical URLsfail
- ✓Mobile viewportpass
- ✓Content accessible without JSpass
- ✓Security headerspass
Other
- ✗nextjs-metadata-apifail
- ✓nextjs-static-generationpass
- ✗nextjs-well-known-servedfail
Score history
- 54/100 · rubric v3.0
- 54/100 · rubric v3.0
- 54/100 · rubric v3.0
- 49/100 · rubric v2.0
- 49/100 · rubric v2.0
- 49/100 · rubric v2.0
- 49/100 · rubric v2.0
- 49/100 · rubric v2.0
- 48/100 · rubric v2.0
- 55/100 · rubric v2.0
- 53/100 · rubric v2.0
- 53/100 · rubric v2.0