Fix: Root HTML links to machine surfaces via

Web-audit fix skill for the root-link-rel check (Discoverability, SHOULD).

Goal

Point link rel elements at your machine surfaces from the root HTML head.

Fix

Add <link rel> elements in your root HTML head pointing at your machine surfaces: rel="service-desc" to the OpenAPI doc, rel="service-doc" to human docs, and rel="alternate" to llms.txt and the MCP card. An agent that lands on the HTML can then discover the structured surfaces without scraping.

Resources

• RFC 8631 (service-desc/doc)

Copy-paste prompt

Paste this into your coding agent, replacing the Issue line with the Result line from your audit:

Verify

Re-run the audit at https://anc.dev/web-audit or call the audit_website MCP tool; the root-link-rel check should report pass.