Add agent-ready skill: make a Cloudflare site discoverable by AI agents#63
Open
Pushingcapital wants to merge 1 commit into
Open
Add agent-ready skill: make a Cloudflare site discoverable by AI agents#63Pushingcapital wants to merge 1 commit into
Pushingcapital wants to merge 1 commit into
Conversation
… AI agents New skill covering the full agent-discovery signal set with Cloudflare-native implementations: RFC 8288 Link headers (via Transform Rule), RFC 9727 api-catalog, MCP Server Card (SEP-1649), A2A Agent Card, agent-skills index, llms.txt, security.txt, AIPREF Content-Signal robots.txt, Markdown for Agents, OAuth/OIDC discovery, and DNS-AID SVCB records + DNSSEC. Emphasizes the dedicated-discovery-worker + Transform-Rule pattern (ships ~11/12 signals without redeploying the main app) and documents the real-world gotchas (route drift, gate 307->HTML, www/apex origin mismatch, edge cache, DNSSEC needs registrar DS, commit-email CI blocks, WebMCP client-JS). Includes a read-only audit.sh and references for the worker, DNS-AID, and troubleshooting. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
A new
agent-readyskill that turns "make my site discoverable to AI agents" into the concrete set of HTTP/DNS/well-known signals agent crawlers look for — implemented the Cloudflare-native way.Covers: RFC 8288 Link headers, RFC 9727 api-catalog (linkset), MCP Server Card (SEP-1649), A2A Agent Card, agent-skills index (agentskills.io), llms.txt, security.txt (RFC 9116), AIPREF Content-Signal robots.txt, Markdown for Agents (zone setting), OAuth/OIDC discovery (RFC 8414/9728), and DNS-AID SVCB records + DNSSEC (draft-mozleywilliams + RFC 9460). Notes WebMCP for completeness.
Why it's Cloudflare-specific
The skill's core guidance is a dedicated discovery Worker on more-specific routes + a Transform Rule for the homepage
Linkheader — which ships ~11 of 12 signals without redeploying or modifying the main application. It also flips Markdown-for-Agents via thecontent_converterzone setting and publishes DNS-AID via the DNS + DNSSEC APIs.Contents
skills/agent-ready/SKILL.md— triggers, the signal table, recommended architecture, flow, and hard-won gotchasreferences/dedicated-discovery-worker.md— workerwrangler.toml+ handler shape, the Link Transform Rule,content_converterreferences/dns-aid.md— SVCB record creation + DNSSEC enable/DS recipereferences/troubleshooting.md— symptom→cause→fix table + token-scope-by-task matrixscripts/audit.sh— read-only, dependency-light probe of every signal for a hostNotes