agent-ready-markdown-negotiation — Claude Code skill
agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-codeWhat agent-ready-markdown-negotiation does
This skill instructs the agent on how to handle Accept: text/markdown headers on your web pages. When requested, the endpoint returns a Markdown version accompanied by the Content-Type: text/markdown response header, while standard visitors still receive default HTML.
It also sets up the optional x-markdown-tokens header to pass token counts when they are available. If your domain is proxied by Cloudflare, Markdown for Agents handles this directly on edge servers without changing your application code.
Validation runs via a POST request to https://isitagentready.com/api/scan with your site URL in the JSON payload. Verification succeeds only when checks.contentAccessibility.markdownNegotiation.status equals pass.
What it helps with
- respond with Markdown when Accept: text/markdown is present
- keep default HTML responses for regular browser requests
- expose page token counts via x-markdown-tokens header
- validate agent readiness through the isitagentready.com scan API
Example prompts for the agent
- Implement Accept: text/markdown content negotiation in this route handler
- Explain how to turn on Markdown for Agents on a Cloudflare zone
- Send a scan request to isitagentready.com and verify our markdownNegotiation check
How to install agent-ready-markdown-negotiation
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-code2Manually: put the files in place
~/.claude/skills/markdown-negotiation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/markdown-negotiation/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a codex2Manually: put the files in place
.agents/skills/markdown-negotiation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a cursor2Manually: put the files in place
.cursor/skills/markdown-negotiation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/markdown-negotiation2Manually: put the files in place
.github/skills/markdown-negotiation/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/markdown-negotiationManually: put the files in place
.devin/skills/markdown-negotiation/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-markdown-negotiation
How to install agent-ready-markdown-negotiation in Claude Code?
Run npx skills add fabricioctelles/skills --skill markdown-negotiation -a claude-code. The skill file will be placed in ~/.claude/skills/markdown-negotiation/SKILL.md.
What does agent-ready-markdown-negotiation do?
It guides the agent to return Markdown responses with appropriate headers when requested, preserving HTML for regular web traffic.
Can Cloudflare handle Markdown negotiation automatically?
Yes. Cloudflare Markdown for Agents enables this feature for Cloudflare zones without modifying backend code.
Source text
SKILL.md · Apache-2.0
---
name: agent-ready-markdown-negotiation
description: >
Sub-skill de agent-ready-cloudflare: Implement Markdown Content Negotiation
---
# Implement Markdown Content Negotiation
Support `Accept: text/markdown` content negotiation so agents can request
markdown versions of your pages.
See [llmstxt.org](https://llmstxt.org/) and
[Markdown for Agents](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/).
## Requirements
- When a request includes `Accept: text/markdown`, return a markdown representation of the page
- Set `Content-Type: text/markdown` on the response
- HTML remains the default for requests without the markdown accept header
- Include an `x-markdown-tokens` header with the token count if available
## Cloudflare
[Markdown for Agents](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/)
enables this automatically for Cloudflare zones — no application code changes needed.
## Validate
```
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.contentAccessibility.markdownNegotiation.status` is `"pass"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills