Как заставить Claude отвечать интерактивной HTML-страницей: пошаговый разбор скилла answer-me-with-html

Как заставить Claude отвечать интерактивной HTML-страницей: пошаговый разбор скилла answer-me-with-html

Скилл переносит верстку диаграмм и карточек в локальный CLI, сокращая объем вывода модели в восемь раз.

В чем проблема длинных ответов и генерации HTML вручную

При разборе архитектуры систем, сравнительном анализе библиотек или объяснении многоэтапных процессов модель выдает полотно текста на два-три экрана терминала. Воспринимать структуру такого ответа сложно, а переслать коллегам без потери контекста практически невозможно. Прямой запрос к модели «ответь в виде красивой HTML-страницы» решает проблему лишь отчасти.

При ручной верстке агент тратит десятки секунд на генерацию сотен строк повторяющегося CSS-кода, разметку контейнеров и подбор SVG-координат для стрелок. На генерацию уходит до минуты времени, расход токенов резко возрастает, а стрелки на диаграммах нередко смещаются или указывают в пустоту.

Как устроен скилл: разделение труда между моделью и CLI

Открытый инструмент answer-me-with-html (6,6 тысячи звезд на GitHub на ноябрь 2026 года под лицензией MIT) разделяет задачу на две части. Модель генерирует только содержательную часть в виде компактного Markdown-черновика со специальными блоками компонентов, а компиляцию стилей, раскладку сетки и отрисовку векторных диаграмм берет на себя локальный CLI.

Черновик ответа, который создает агент, выглядит лаконично:

--- title: TCP three-way handshake --- ## A Three-way handshake {span=2} :::sequence num Client -> Server: SYN, seq=x Server -> Client: SYN+ACK, seq=y, ack=x+1 Client -> Server: ACK, ack=y+1 note Client, Server: ESTABLISHED ::: ## C State changes {span=2} :::flow LR (CLOSED) -> LISTEN: passive open LISTEN -> SYN_RCVD: get SYN / send SYN+ACK SYN_RCVD -> *ESTABLISHED: get ACK :::

На основе этих строк CLI рассчитывает точные координаты блоков с помощью библиотеки dagre, парсит текст через marked и формирует автономный HTML-документ без внешних CDN-скриптов и удаленных шрифтов. Готовая страница открывается офлайн в браузере, а исходный Markdown-код вшит внутрь файла и извлекается кнопкой «Copy source».

Интерфейс проекта: страница формируется за 50 мс из Markdown-черновика. Источник: answer-me-with-html.com
Интерфейс проекта: страница формируется за 50 мс из Markdown-черновика. Источник: answer-me-with-html.com

Поддерживаемые компоненты и темы оформления

Инструмент содержит готовый набор компонентов под разные типы инженерной информации. Модель выбирает формат блока в зависимости от структуры ответа:

  • 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:

/plugin marketplace add QingYunA/answer-me-with-html /plugin install answer-me-with-html@answer-me-with-html

Второй вариант — установка через менеджер навыков npx skills:

npx skills add QingYunA/answer-me-with-html

Третий вариант — ручное копирование репозитория в каталог пользовательских скиллов Claude Code:

git clone --depth 1 https://github.com/QingYunA/answer-me-with-html.git /tmp/answer-me-with-html cp -R /tmp/answer-me-with-html/skills/answer-me-with-html ~/.claude/skills/answer-me-with-html
Репозиторий проекта на GitHub: версия 0.6.2, открытый исходный код под лицензией MIT. Источник: GitHub / QingYunA
Репозиторий проекта на GitHub: версия 0.6.2, открытый исходный код под лицензией MIT. Источник: GitHub / QingYunA

Замеры эффективности: токены, время генерации и стоимость

На сайте разработчика приведены контрольные замеры производительности на задачах генерации документации с использованием модели Claude Sonnet 3.5 в среде Claude Code. Сравнивался прямой вывод HTML моделью и формирование ответа через Markdown-скилл.

Сравнение метрик прямого вывода HTML и работы со скиллом. Данные: answer-me-with-html.com
Сравнение метрик прямого вывода HTML и работы со скиллом. Данные: answer-me-with-html.com
  • Количество выходных токенов: сокращается с 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 без воды».