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
npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a claude-codeWhat 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-catalogvia 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-code2Manually: put the files in place
~/.claude/skills/link-headers/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/link-headers/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a codex2Manually: put the files in place
.agents/skills/link-headers/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a cursor2Manually: put the files in place
.cursor/skills/link-headers/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/link-headers2Manually: put the files in place
.github/skills/link-headers/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-link-headers -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/link-headersManually: put the files in place
.devin/skills/link-headers/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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