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 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.
9% of the scoreRobots.txtHow to configure robots.txt for AI crawlers: the missing file, unconfigured crawlers, wildcard blocks, and Sitemap directives.
9% of the 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.
7% of the scoreAgent OperabilityHow to make a page an agent can operate rather than only read: real controls, accessible names, labelled fields, and the entry blockers that hide everything behind them.
6% 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.
6% of the scoreAI DirectivesHow the page-level AI directives work: noindex, nosnippet, max-snippet, noarchive, nocache, data-nosnippet, and why Google-Extended does not do what most people think.
5% of the scoreLLMs.txtHow to create a spec-compliant /llms.txt file: the missing file, headings, blockquotes, sections, links, and llms-full.txt.
5% of the scoreSEO BasicsFoundational head-tag hygiene every agent uses: title length, meta description, canonical URL, html lang, charset, viewport, and hreflang.
4% of the scoreOpenAPI SpecHow to create an OpenAPI specification for AI agents: the missing file, version, info, paths, and servers.
4% of the scoreHTTP HeadersHow to configure HTTP headers for AI agents: security headers, AI discovery Link headers, and CORS for .well-known resources.
4% of the scoreContent NegotiationServe Markdown to AI agents via Accept: text/markdown, send Vary: Accept, avoid relabeled HTML, and advertise rel=alternate fallbacks.
4% of the scoreUsage PolicyHow to state your AI usage terms in a way machines can read, and how to stop five mechanisms contradicting each other: Content Signals, AIPREF, RSL, TDMRep and robots meta.
4% of the scoreHTTP HygieneHow to make your server tell an agent the truth: soft 404s, redirect chains, refused HEAD, missing charset, and 429 without Retry-After.
3% 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.
3% of the scoreSecurity.txtHow to create a security.txt file per RFC 9116: the missing file, required fields, expired dates, and optional fields.
3% of the scoreMCP (Model Context Protocol)How to create a Model Context Protocol configuration: the missing file, server metadata, tools, resources, and CORS.
3% of the scoreTLS / HTTPSServe over HTTPS, redirect HTTP to HTTPS, and configure HSTS with preload and includeSubDomains. Agents downgrade trust on insecure origins.
2% 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.
2% of the 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.
2% of the scoreCrawl EfficiencyEnable Brotli or gzip compression, support conditional GET with ETag and Last-Modified, and keep pages a size an agent's budget survives.
2% of the scoreAgent SkillsHow to publish agent skills a site can be operated by: the index, SKILL.md frontmatter, digests, and the naming rules the specification enforces.
1% of the scoreMeta TagsHow to add AI meta tags, rel=alternate links, rel=me identity links, and Open Graph tags.
1% of the scoreAuth DiscoveryHow an agent finds its way past a 401: RFC 9728 protected-resource metadata, RFC 8414 server metadata, PKCE and dynamic registration.
Reports, does not scoreAI CatalogHow to publish an agent resource catalog: ai-catalog.json and ard.json, entry types, and why an entry pointing at nothing is worse than no catalog.
Reports, does not scoreWebMCPHow to declare a form as a callable tool with WebMCP: toolname, tooldescription, parameter descriptions, and the deprecated namespace.
Reports, does not scoreCommerce DiscoveryHow to publish a UCP commerce profile so an agent can complete a purchase: services, schemas, payment handlers and keys.