# agent-ready-markdown-negotiation

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 141 у репозитория
- Автор: fabricioctelles
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/markdown-negotiation/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/markdown-negotiation/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/markdown-negotiation/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/markdown-negotiation/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/markdown-negotiation/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/markdown-negotiation
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/markdown-negotiation/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-markdown-negotiation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/markdown-negotiation
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/markdown-negotiation/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/markdown-negotiation/SKILL.md

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

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

## Похожие
- [Markdown Renderer — Styled HTML with CSS Themes](https://affpapa.org/nevibecode/mcp/markdown-renderer-styled-html-with-css-themes.md) — MCP-сервер · 2621 установка
- [baoyu-format-markdown](https://affpapa.org/nevibecode/skills/baoyu-format-markdown.md) — скилл · 28800 установок
- [cmux-markdown](https://affpapa.org/nevibecode/skills/cmux-markdown.md) — скилл · 7900 установок
- [markdown-mermaid-writing](https://affpapa.org/nevibecode/skills/markdown-mermaid-writing.md) — скилл · 2300 установок
- [markdown-documentation](https://affpapa.org/nevibecode/skills/markdown-documentation.md) — скилл · 1300 установок
- [pdf-to-markdown](https://affpapa.org/nevibecode/skills/pdf-to-markdown.md) — скилл · 870 установок

Из того же набора: [fabricioctelles/skills](https://affpapa.org/nevibecode/by/fabricioctelles/skills.md) — 46 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
