Remediation guides
One guide per check, finding by finding: what the engine looks for, why it matters to an agent, and the exact change that satisfies it.
- 11% of the scoreLLMs.txtHow to create a spec-compliant /llms.txt file: the missing file, headings, blockquotes, sections, links, and llms-full.txt.
- 11% of the scoreRobots.txtHow to configure robots.txt for AI crawlers: the missing file, unconfigured crawlers, wildcard blocks, and Sitemap directives.
- 9% of the scoreStructured DataHow to add JSON-LD structured data for AI agents: missing blocks, invalid JSON, schema.org context, @graph, entity types, and BreadcrumbList.
- 9% of the scoreHTTP HeadersHow to configure HTTP headers for AI agents: security headers, AI discovery Link headers, and CORS for .well-known resources.
- 9% of the scoreHTML RenderingHow to fix HTML rendering for agents that do not run JavaScript: SPA-shell symptoms, semantic landmarks, a single H1, alt coverage, and a noscript fallback.
- 7% of the scoreAgent Card (A2A)How to create an A2A agent.json card: the missing file, invalid JSON, required fields, skills, protocol version, and optional fields.
- 7% of the scoreMCP (Model Context Protocol)How to create a Model Context Protocol configuration: the missing file, server metadata, tools, resources, and CORS.
- 7% of the scoreSEO BasicsFoundational head-tag hygiene every agent uses: title length, meta description, canonical URL, html lang, charset, viewport, and hreflang.
- 6% of the scoreSecurity.txtHow to create a security.txt file per RFC 9116: the missing file, required fields, expired dates, and optional fields.
- 6% of the scoreMeta TagsHow to add AI meta tags, rel=alternate links, rel=me identity links, and Open Graph tags.
- 6% of the scoreOpenAPI SpecHow to create an OpenAPI specification for AI agents: the missing file, version, info, paths, and servers.
- 5% of the scoreTLS / HTTPSServe over HTTPS, redirect HTTP to HTTPS, and configure HSTS with preload and includeSubDomains. Agents downgrade trust on insecure origins.
- 4% of the scoreSitemapHow to fix your sitemap: missing sitemap.xml, invalid XML, empty urlset, missing lastmod, stale entries, sitemap-index handling, content type, and the 50k URL limit.
- 3% of the scoreAI Well-KnownPublish emerging AI discovery files: ai.txt, genai.txt, ai-plugin.json, agents.json, and nlweb.json, each with its state of adoption.
- Reports, does not scoreContent NegotiationServe Markdown to AI agents via Accept: text/markdown, send Vary: Accept, avoid relabeled HTML, and advertise rel=alternate fallbacks.
- Reports, does not scoreRSL LicenseDeclare Really Simple Licensing terms via a robots.txt License directive and publish a valid license.xml with the right namespace, permits vocabulary, and payment types.
- Reports, does not scoreAgent AccessAI crawler user-agents blocked by your WAF despite robots.txt allowing them, or served reduced content. Align firewall rules with your declared crawler policy.
- Reports, does not scoreCrawl EfficiencyEnable Brotli or gzip compression, support conditional GET with ETag and Last-Modified, and keep pages a size an agent's budget survives.