К основному содержанию
скилл CX Codex

agent-ready-markdown-negotiation — скилл для Claude Code

Скилл agent-ready-markdown-negotiation настраивает согласование контента по заголовку Accept: text/markdown, отдавая агентам лёгкие Markdown-версии веб-страниц вместо HTML.

Apache-2.0 ★ 141 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-code
Открыть на GitHub

Что делает agent-ready-markdown-negotiation

Скилл объясняет агенту, как реализовать поддержку Accept: text/markdown на сервере или через CDN. По запросу с таким заголовком сервер отдаёт представление страницы в Markdown с заголовком ответа Content-Type: text/markdown. Обычные запросы без этого заголовка продолжают получать стандартный HTML.

Если число токенов известно, скилл предписывает передавать его в заголовке x-markdown-tokens. Для зон под управлением Cloudflare писать код в приложении не придётся: функция Markdown for Agents включает такую обработку автоматически на уровне сети.

Проверить корректность настройки можно отправкой JSON с адресом сайта на эндпоинт https://isitagentready.com/api/scan — тест считается пройденным, когда поле checks.contentAccessibility.markdownNegotiation.status возвращает pass.

Какие задачи решает

  • настроить отдачу Markdown по заголовку Accept: text/markdown
  • сохранить стандартную выдачу HTML для обычных браузеров
  • добавить заголовок x-markdown-tokens с количеством токенов
  • проверить готовность сайта к работе с агентами через сканер

Примеры запросов агенту

  • Настрой отдачу Markdown по заголовку Accept: text/markdown для нашего роута
  • Покажи, как включить Markdown for Agents в Cloudflare без правок в коде бэкенда
  • Сделай проверку сайта через API isitagentready.com и разбери статус markdownNegotiation

Как установить agent-ready-markdown-negotiation

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/markdown-negotiation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об agent-ready-markdown-negotiation

Как установить agent-ready-markdown-negotiation в Claude Code?

Выполните команду npx skills add fabricioctelles/skills --skill markdown-negotiation -a claude-code. Файл скилла сохранится в ~/.claude/skills/markdown-negotiation/SKILL.md.

Что делает этот скилл?

Он задаёт правила согласования контента: возвращает Markdown и заголовок Content-Type: text/markdown, когда клиент запрашивает этот формат, сохраняя HTML по умолчанию.

Обязательно ли менять код приложения для поддержки Markdown?

Нет, если домен обслуживается через Cloudflare: функция Markdown for Agents подключает такое согласование автоматически без правок в коде.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
Markdown Renderer — Styled HTML with CSS Themes axel-belfort MCP-сервер Markdown Renderer — Styled HTML with CSS Themes для Claude Code превращает Markdown в HTML с CSS-темой. Вызывается для оформления отчётов, документации и публикаций. CX Codex +1 2 621установок baoyu-format-markdown JimLiu Скилл baoyu-format-markdown форматирует plain text и Markdown: добавляет структуру, frontmatter, заголовки, списки и код. Результат сохраняется в {filename}-formatted.md. CX Codex +1 28 800установок cmux-markdown manaflow-ai Скилл cmux-markdown для Claude Code открывает Markdown в отдельной панели рядом с терминалом и обновляет её при изменении файла. Показывает планы, заметки и документацию. CX Codex +1 7 900установок markdown-mermaid-writing K-Dense-AI Скилл markdown-mermaid-writing пишет научную документацию в Markdown и рисует структурные диаграммы Mermaid: схемы процессов, связей, таймлайны. Полезен, когда отчёт или README должны лежать в git как текст. CX Codex +1 2 300установок markdown-documentation aj-geddes Скилл markdown-documentation для Claude Code задаёт агенту правила оформления Markdown: README, вики, страницы документации. Приводит тексты, которые пишет модель, к единому виду. CX Codex +1 1 300установок pdf-to-markdown PSPDFKit-labs Скилл pdf-to-markdown для Claude Code и Codex. Превращает PDF в структурированный Markdown: заголовки, таблицы, списки и порядок чтения сохраняются. Извлекает текст для анализа или передачи агенту. CX Codex +1 870установок

Из того же набора46

Весь набор →
agent-ready-web-bot-auth Скилл agent-ready-web-bot-auth для Claude Code описывает настройку Web Bot Auth, чтобы сайты проверяли подписи запросов ботов и агентов. Настройка включает публикацию JWKS и подпись исходящих запросов. CX Codex +1 ★ 141звёзд репо agent-ready-agent-skills Скилл agent-ready-agent-skills помогает развернуть индекс обнаружения навыков агентов по спецификации RFC v0.2.0. Он настраивает отдачу JSON-документа и проверяет сайт через сканер. CX Codex +1 ★ 141звёзд репо agent-ready-oauth-protected-resource Скилл agent-ready-oauth-protected-resource публикует OAuth Protected Resource Metadata для обнаружения способа аутентификации агентами. Нужен при настройке защищённого ресурса на Cloudflare. CX Codex +1 ★ 141звёзд репо agent-ready-link-headers Скилл agent-ready-link-headers для Claude Code добавляет Link-заголовки ответов на главную страницу сайта. ИИ-агенты автоматически обнаруживают API и документацию. CX Codex +1 ★ 141звёзд репо agent-ready-webmcp Скилл agent-ready-webmcp добавляет в сайт поддержку WebMCP API, чтобы браузерные ИИ-агенты видели и вызывали его функции. CX Codex +1 ★ 141звёзд репо agent-ready-ai-rules Скилл agent-ready-ai-rules для Claude Code и Codex добавляет в robots.txt правила RFC 9309 для AI-поисковиков и обучающих ботов. Контролирует показ страниц в ответах AI-ассистентов и их использование для обучения. CX Codex +1 ★ 141звёзд репо agent-ready-mpp Скилл agent-ready-mpp помогает внедрить Machine Payment Protocol (MPP) в OpenAPI, добавляя разметку x-payment-info для платных эндпоинтов вашего API. CX Codex +1 ★ 141звёзд репо agent-ready-dns-aid Скилл agent-ready-dns-aid для Claude Code публикует DNS-AID-записи, чтобы агенты находили endpoint через DNS. Настраивает SVCB или HTTPS-записи в пространстве _agents. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой