# Markdown Accessibility Assistant

Проверяет существующие Markdown-документы на проблемы доступности и исправляет структуру, ссылки и списки. Подходит для ревью документации.

- субагент · `type=agent` · GitHub Copilot · ★ 40451
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/markdown-accessibility-assistant.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/markdown-accessibility-assistant

## Что делает

Markdown Accessibility Assistant проверяет существующие Markdown-файлы по пяти направлениям: описательные ссылки, ALT-текст изображений, иерархия заголовков, простой язык и корректные списки. Он не создаёт документацию с нуля. Субагент может работать с локальными файлами и GitHub PR.

В рабочем процессе он читает файл, запускает `npx --yes markdownlint-cli2 <filepath>`, затем ищет проблемы с помощью `read`, `search`, `edit` и `execute`. Структурные ошибки ссылок, заголовков и списков он может исправлять сам, а для ALT-текста и упрощения формулировок сначала даёт замечания и предложения.

Без подтверждения человека субагент не меняет ALT-текст и формулировки простого языка, потому что для них нужен контекст изображения, аудитории и тона документа.

## Требования
- Работает с: GitHub

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/markdown-accessibility-assistant.agent.md`

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/markdown-accessibility-assistant.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/markdown-accessibility-assistant.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/agents/markdown-accessibility-assistant.agent.md

## Когда брать
- проверить иерархию заголовков в Markdown
- заменить неоднозначные тексты ссылок
- найти изображения без подходящего ALT-текста
- проверить разметку вложенных списков
- выявить формулировки, которые стоит упростить

## Примеры запросов агенту
- Проверь `README.md` на доступность и исправь проблемы со ссылками, заголовками и списками.
- Запусти проверку доступности для `docs/guide.md`, а замечания по ALT-тексту и сложным формулировкам вынеси отдельно.
- Проверь Markdown-файлы в этом PR через `npx --yes markdownlint-cli2 <filepath>` и объясни каждое изменение.

## Похожие
- [convert-documents-to-markdown](https://affpapa.org/nevibecode/skills/convert-documents-to-markdown.md) — скилл · 12600 установок
- [cmux-markdown](https://affpapa.org/nevibecode/skills/cmux-markdown.md) — скилл · 7500 установок
- [prompt-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-prompt-engineer.md) — субагент · 16078 установок
- [context-manager](https://affpapa.org/nevibecode/agents/context-manager.md) — субагент · 10638 установок
- [code-explorer](https://affpapa.org/nevibecode/agents/code-explorer.md) — субагент · 1172 установки
- [search-specialist](https://affpapa.org/nevibecode/agents/search-specialist.md) — субагент · 6886 установок
- [api-documenter](https://affpapa.org/nevibecode/agents/api-documenter.md) — субагент · 6451 установка
- [technical-writer](https://affpapa.org/nevibecode/agents/technical-writer.md) — субагент · 4345 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 954 карточки

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

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