Как заставить Claude отвечать интерактивной HTML-страницей: пошаговый разбор скилла answer-me-with-html
Скилл переносит верстку диаграмм и карточек в локальный CLI, сокращая объем вывода модели в восемь раз.
В чем проблема длинных ответов и генерации HTML вручную
При разборе архитектуры систем, сравнительном анализе библиотек или объяснении многоэтапных процессов модель выдает полотно текста на два-три экрана терминала. Воспринимать структуру такого ответа сложно, а переслать коллегам без потери контекста практически невозможно. Прямой запрос к модели «ответь в виде красивой HTML-страницы» решает проблему лишь отчасти.
При ручной верстке агент тратит десятки секунд на генерацию сотен строк повторяющегося CSS-кода, разметку контейнеров и подбор SVG-координат для стрелок. На генерацию уходит до минуты времени, расход токенов резко возрастает, а стрелки на диаграммах нередко смещаются или указывают в пустоту.
Как устроен скилл: разделение труда между моделью и CLI
Открытый инструмент answer-me-with-html (6,6 тысячи звезд на GitHub на ноябрь 2026 года под лицензией MIT) разделяет задачу на две части. Модель генерирует только содержательную часть в виде компактного Markdown-черновика со специальными блоками компонентов, а компиляцию стилей, раскладку сетки и отрисовку векторных диаграмм берет на себя локальный CLI.
Черновик ответа, который создает агент, выглядит лаконично:
На основе этих строк CLI рассчитывает точные координаты блоков с помощью библиотеки dagre, парсит текст через marked и формирует автономный HTML-документ без внешних CDN-скриптов и удаленных шрифтов. Готовая страница открывается офлайн в браузере, а исходный Markdown-код вшит внутрь файла и извлекается кнопкой «Copy source».
Поддерживаемые компоненты и темы оформления
Инструмент содержит готовый набор компонентов под разные типы инженерной информации. Модель выбирает формат блока в зависимости от структуры ответа:
- flow и state — автоматическая раскладка блок-схем алгоритмов, цепочек вызовов и графов состояний с переходами.
- sequence — диаграммы последовательностей обмена сообщениями между микросервисами с автоподбором ширины колонок.
- er и class — диаграммы связей сущностей баз данных (нотация «воронья лапка») и структуры классов с атрибутами и методами.
- api — контракты HTTP и RPC с параметрами запросов, телами ответов и кодами возврата.
- table с директивой {table sort filter} — таблицы с интерактивной сортировкой по клику на заголовок и фильтрацией строк без JavaScript-фреймворков.
- code с аргументами src= и lines= — цитирование реального кода из локальных файлов проекта с запретом на доступ к файлам ключей и путям вне каталога.
- ask — блок интерактивного выбора вариантов решения прямо на странице; кнопка Reply копирует выбранные опции в виде сообщения для агента.
В комплекте идут три визуальные темы: blueprint в стиле инженерных чертежей, shadcn с минималистичными карточками и paper для чтения объемных технических текстов. Все темы поддерживают светлый и темный режимы оформления.
Проверка технического текста по стандарту ASD-STE100
В компилятор встроен статический анализатор текста на соответствие правилам ASD-STE100 — упрощенного технического английского языка, созданного для документации в авиастроении. Стандарт требует четких формулировок, прямого порядка слов и отсутствия двусмысленности.
При сборке страницы CLI контролирует длину предложений (до 20 слов для пошаговых действий и до 25 слов для описаний), подменяет сложные синонимы простыми аналогами и отслеживает пассивный залог. По умолчанию компилятор выдает неблокирующие предупреждения, но при включении строгого режима командой конфигурации черновики с нарушениями отклоняются до исправления агентом.
Способы установки скилла в агентские среды
Для работы инструмента требуется среда Node.js версии 20 или новее. Скилл совместим с Claude Code, Cursor, Codex, OpenCode и DeepSeek Harness. Установка выполняется одним из трех способов.
Первый вариант — официальный каталог плагинов Claude Code:
Второй вариант — установка через менеджер навыков npx skills:
Третий вариант — ручное копирование репозитория в каталог пользовательских скиллов Claude Code:
Замеры эффективности: токены, время генерации и стоимость
На сайте разработчика приведены контрольные замеры производительности на задачах генерации документации с использованием модели Claude Sonnet 3.5 в среде Claude Code. Сравнивался прямой вывод HTML моделью и формирование ответа через Markdown-скилл.
- Количество выходных токенов: сокращается с 4 893 до 612 токенов (в 8 раз меньше за счет переноса CSS и SVG в компилятор).
- Время формирования ответа: падает с 31 до 12 секунд (ускорение в 2,6 раза).
- Стоимость одного ответа: снижается с $0.091 до $0.077 (экономия около 15%).
- Объем итогового документа: черновик размером 1,3 КБ компилируется в автономную страницу на 80,6 КБ примерно за 50 миллисекунд.
Ограничения инструмента и альтернативные решения
- Избыточность для простых задач: для коротких ответов и поиска команд в терминале генерация полноценной веб-страницы создает лишний шаг и тратит время.
- Накопление файлов на диске: сгенерированные страницы сохраняются в домашней директории ~/.answer-me-with-html/ и требуют регулярной очистки по запросу к агенту.
- Локальные зависимости: для компиляции требуется среда Node.js 20+, без которой исполняемый файл CLI не запустится.
- Повторные ходы при строгом режиме: при строгой проверке стиля по стандарту STE агент расходует дополнительные токены на исправление замечаний линтера.
- Альтернативы: для визуализации архитектуры сервисов существует скилл Archify, а для базовых блок-схем зачастую достаточно встроенного синтаксиса Mermaid.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».