Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

~/.claude/skills/markdown-negotiation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/markdown-negotiation/

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

Similar skills

All skills for Backend and APIs →

From the same set46

The whole set →
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-link-headers 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. 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 agent-ready-dns-aid The agent-ready-dns-aid skill guides DNS-AID records that let agents locate endpoints through DNS. Use it when publishing SVCB or HTTPS records under _agents. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open