# Fix: Root HTML links to machine surfaces via <link rel>

> 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)](https://www.rfc-editor.org/rfc/rfc8631)

## Copy-paste prompt

Paste this into your coding agent, replacing the Issue line with the Result line from [your audit](https://anc.dev/web-audit):

```text
Goal: Point link rel elements at your machine surfaces from the root HTML head
Issue: <the audit's finding for this check>
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.
Skill: https://anc.dev/web-audit/skill/root-link-rel
Docs: https://www.rfc-editor.org/rfc/rfc8631
```

## Verify

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