agent-ready-markdown-negotiation — скилл для Claude Code
Скилл agent-ready-markdown-negotiation настраивает согласование контента по заголовку Accept: text/markdown, отдавая агентам лёгкие Markdown-версии веб-страниц вместо HTML.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/markdown-negotiation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/markdown-negotiation/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a codex2Вручную: положить файлы
.agents/skills/markdown-negotiation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a cursor2Вручную: положить файлы
.cursor/skills/markdown-negotiation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/markdown-negotiation2Вручную: положить файлы
.github/skills/markdown-negotiation/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/markdown-negotiationВручную: положить файлы
.devin/skills/markdown-negotiation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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