Skip to main content
skill CX Codex

agent-ready-link-headers — Claude Code skill: Link headers for agents

agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically.

Apache-2.0 ★ 141 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a claude-code
Open on GitHub

What agent-ready-link-headers does

agent-ready-link-headers implements RFC 8288 and RFC 9727 by adding headers like Link: </.well-known/api-catalog>; rel="api-catalog" to your homepage without modifying your origin server. The skill works via Cloudflare Transform Rules or Workers, so deployment takes minutes.

It specifies which relation types to use (api-catalog, service-desc, service-doc, describedby) and how to validate the result through isitagentready.com — verification confirms that agents can actually discover you.

Installation depends on your platform: for Claude Code, run npx skills add fabricioctelles/skills --skill link-headers -a claude-code; for Codex, npx skills add fabricioctelles/skills --skill link-headers -a codex. After installation, the SKILL.md file is available in the skill's folder.

What it helps with

  • Make your site visible to AI agents without changing server code
  • Add Link headers via Cloudflare when you cannot modify your origin
  • Validate that headers are correctly set and agents can read them
  • Use standard relation types for RFC compliance

Example prompts for the agent

  • Install the skill and add a Link header for /.well-known/api-catalog via Cloudflare Transform Rules
  • Set up multiple Link headers with different relation types and verify them on isitagentready.com
  • Use the skill to quickly make your site agent-ready per standards without rewriting server code

How to install agent-ready-link-headers

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a claude-code

2Manually: put the files in place

~/.claude/skills/link-headers/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/link-headers/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-link-headers

How do I install agent-ready-link-headers in Claude Code?

Run npx skills add fabricioctelles/skills --skill link-headers -a claude-code. Then open ~/.claude/skills/link-headers/SKILL.md for the full skill instructions.

Why do AI agents need Link headers?

Link headers let AI agents discover your API, documentation, and other machine-readable resources without prior configuration. This follows RFC 8288 and RFC 9727, which agents support natively.

Can I add Link headers if I cannot modify my server code?

Yes, the skill recommends Cloudflare Transform Rules or Workers. You add headers at the CDN level without touching your origin server.

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-link-headers
description: >
  Sub-skill de agent-ready-cloudflare: Implement Link Response Headers
---
# Implement Link Response Headers

Add Link response headers to your homepage for agent discovery per
[RFC 8288](https://www.rfc-editor.org/rfc/rfc8288) and
[RFC 9727 Section 3](https://www.rfc-editor.org/rfc/rfc9727#section-3).

## Requirements

- Return `Link` headers on your homepage response pointing to machine-readable resources
- Use registered relation types: `api-catalog`, `service-desc`, `service-doc`, `describedby`
- Example: `Link: </.well-known/api-catalog>; rel="api-catalog"`
- Multiple Link headers or comma-separated values are both valid

## Cloudflare

Use [Transform Rules](https://developers.cloudflare.com/rules/transform/) or
[Workers](https://developers.cloudflare.com/workers/) to add Link headers
without modifying your origin server.

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.discoverability.linkHeaders.status` is `"pass"`.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set46

The whole set →
agent-ready-a2a-agent-card agent-ready-a2a-agent-card generates an A2A Agent Card file for agent-to-agent discovery. Useful when setting up agent endpoints on Cloudflare Workers. CX Codex +1 ★ 141repo stars agent-ready-web-bot-auth The agent-ready-web-bot-auth skill guides Web Bot Auth setup so receiving sites can verify bot or agent requests. Use it when your site needs to identify its signed outbound traffic. CX Codex +1 ★ 141repo stars agent-ready-agent-skills agent-ready-agent-skills publishes an agent skills discovery index matching the RFC v0.2.0 specification. Useful when exposing local agent tools to external crawlers. CX Codex +1 ★ 141repo stars agent-ready-oauth-protected-resource agent-ready-oauth-protected-resource publishes OAuth Protected Resource Metadata so agents can discover how to authenticate. It fits Cloudflare setups that expose a protected resource. CX Codex +1 ★ 141repo stars agent-ready-markdown-negotiation agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML. CX Codex +1 ★ 141repo stars agent-ready-webmcp agent-ready-webmcp wires a site's actions into the WebMCP API so browser-based AI agents can find and call them. CX Codex +1 ★ 141repo stars agent-ready-ai-rules agent-ready-ai-rules is a skill that adds RFC 9309 rules for AI search and training crawlers to robots.txt, controlling page visibility in AI answers and use for model training. CX Codex +1 ★ 141repo stars agent-ready-mpp agent-ready-mpp teaches AI agents to configure Machine Payment Protocol (MPP) discovery in OpenAPI schemas by adding x-payment-info tags to payable endpoints. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open