---
name: link-headers
title: Link headers
category: discoverability
---

# Link headers

RFC 8288 Link headers attach related resources to any HTTP response. Browsers ignore them; agents that read them skip a whole round of HTML parsing.

## When to use this skill

Use this when a site fails the "Link headers" check and you need to implement it.

## Goal

Include Link response headers for agent discovery (RFC 8288)

## Pass criteria

The homepage response carries Link headers with at least one agent-useful relation.

## Implementation

This skill covers the diagnosis. The step-by-step implementation prompt is part
of the paid tier and is served per scan by the API — see https://agent-ready.t0ols.com/llms-full.txt.

## Specifications

- https://www.rfc-editor.org/rfc/rfc8288
- https://www.rfc-editor.org/rfc/rfc9727#section-3

## Verifying

Re-run the scan against the site and confirm the check reports a pass:

    curl -s https://agent-ready.t0ols.com/api/scan \
      -H 'content-type: application/json' \
      -d '{"url":"https://example.com","enabledChecks":["linkHeaders"]}'