skills.rest
fabricioctelles
fabricioctellesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-ready-markdown-negotiation

Implement text/markdown content negotiation for Cloudflare-hosted sites and HTTP handlers.

47|4|Updated Feb 21, 2026
Search Tags:#ai agents#cloudflare#http headers#content negotiation#content accessibility#markdown negotiation
One-click install
npx skills add https://github.com/fabricioctelles/skills --skill agent-ready-markdown-negotiation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-ready-markdown-negotiation
Source: https://github.com/fabricioctelles/skills/tree/main/skills/agent-ready-cloudflare/markdown-negotiation
Command: npx skills add https://github.com/fabricioctelles/skills --skill agent-ready-markdown-negotiation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps websites serve machine-readable Markdown to AI agents while preserving standard HTML delivery for regular browser requests.

Core Features & Use Cases

  • Content Negotiation: Detect requests that include the text/markdown media type and return a Markdown representation of the page.
  • Response Compliance: Set the correct Content-Type and optionally provide an x-markdown-tokens header with the token count.
  • Use Case: Configure a Cloudflare-hosted site or application so agents can request concise Markdown content for indexing, analysis, and retrieval without changing the default HTML experience.

Quick Start

Use the Markdown negotiation skill to configure and validate text/markdown responses for my website.

Frequently Asked Questions about agent-ready-markdown-negotiation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I serve Markdown to AI agents instead of HTML?▼

Markdown content negotiation detects requests with the text/markdown Accept header and returns a Markdown representation, preserving standard HTML delivery for regular browser requests.

Does Cloudflare support text/markdown content negotiation for AI agents?▼

Yes, you can configure Cloudflare-hosted sites and application-level HTTP handlers to return Markdown content to AI agents while retaining HTML as the default response.

What HTTP headers are needed for agent-ready Markdown content?▼

Agent-ready Markdown negotiation requires handling the text/markdown Accept header, returning a text/markdown Content-Type response, and optionally including an x-markdown-tokens header with the token count.

How do I validate if my website is serving Markdown correctly to AI agents?▼

You can validate your Markdown negotiation setup through the isitagentready.com scanner to ensure your site correctly serves machine-readable content to AI agents.

Can I return Markdown to AI agents without breaking regular browser requests?▼

Yes, Markdown negotiation preserves the default HTML experience for browsers by only returning Markdown representations when the text/markdown media type is explicitly requested.

What is the x-markdown-tokens header used for in content negotiation?▼

The x-markdown-tokens header optionally reports the token count of the returned Markdown content, helping AI agents understand the size of the machine-readable representation for indexing and analysis.

Related Skills

Explore More Software Engineering Skills→
mjamoremjamore

expo-api-routes

Implement secure Expo Router API routes with environment variables and Cloudflare Workers.

Community
Intermediate
berkayoztuncberkayoztunc
21

Markdown Negotiation Support

Return Markdown responses with token counts when Accept headers request it.

Community
Basic
lightfastailightfastai
2

seo

Optimize Lightfast page content for search engines and AI answer engines.

Official
Advanced
forwardimpactforwardimpact
4

libs-web-presentation

Convert Markdown to HTML and generate static documentation sites.

Official
Intermediate