Рассылка размером более 102 КБ обрезается в Gmail ссылкой «Показать полностью», скрывая вместе с остальным содержимым ссылку отписки и ваш адрес. Приветствие «Привет, *|FNAME|,» с одной пропущенной звёздочкой отправляется всем подписчикам как необработанный текст, а рекламное письмо в виде одной большой картинки превращается в пустой прямоугольник там, где изображения заблокированы. Этот навык находит эти и ещё десять ошибок шаблонов писем до отправки и объясняет каждую простыми словами.

Ваш агент запускает сканер для шаблонов: файлов .mjml, а также .html, .hbs, .liquid, .njk, .twig, .ejs, Jinja, .html.erb и .blade.php, которые находятся в папке писем или содержат почтовую разметку (стили Outlook mso, теги подстановки Mailchimp, MJML). Он читает HTML для Outlook внутри комментариев [if mso], воспринимает теги подстановки вроде {{ first_name }} и |FNAME| как плейсхолдеры и знает теги отписки Mailchimp, SendGrid, Klaviyo, HubSpot, Postmark, Brevo, Campaign Monitor и Mailgun. Он определяет предположительно рекламные письма по именам файлов и формулировкам: для квитанций, напоминаний и сброса пароля с соответствующими именами ссылка отписки не требуется; её отсутствие даёт статус БЛОКИРОВКА только при явных рекламных формулировках, а менее убедительные признаки получают статус ПРОВЕРКА для вашей оценки. Сканер никогда не отправляет письма, не подставляет значения в теги и не открывает ссылки. Результат: БЛОКИРОВКА, ПРОВЕРКА или НЕ ОТМЕЧЕНО с указанием файла, строки, причины и более безопасного подхода. Секретные данные никогда не выводятся.

Что проверяется

БЛОКИРОВКА (исправить до выпуска)

• E01: явно рекламные письма (две продающие фразы, например «скидка 15%» и «используйте код», либо имя файла рассылки или промоакции и одна такая фраза) без ссылки отписки или тега её подстановки

• E02: HTML размером более примерно 102 КБ (в байтах UTF-8), который Gmail обрезает

• E03: ссылки, начинающиеся с javascript:, vbscript: или data:, включая кнопки MJML и Outlook VML

ПРОВЕРКА (проверить до выпуска)

• E11: изображения без alt-текста или с именем файла вместо alt-текста (img и mj-image)

• E12: письма, состоящие только из изображений и почти не содержащие обычного текста

• E13: отсутствие прехедера (текста предпросмотра), из-за чего во входящих вместо него видно «Открыть письмо в браузере»

• E14: таблицы, ячейки, изображения или контейнеры шире 640 пикселей, включая блоки стилей и таблицы только для Outlook

• E15: рекламные письма без почтового адреса или тега его подстановки

• E16: неинформативные тексты ссылок, например «нажмите здесь», «здесь», «читать далее» и «узнать больше»

• E17: повреждённые теги подстановки: {{ без }}, | без |, {% без %}, пустые теги, непарные скобки, а также блоки if, for, #each или |IF:| без завершения

• E18: ссылки-заглушки: href="#", пустые ссылки, localhost и пути file:

• E19: предположительно рекламные письма (на это указывает только имя файла или одна продающая фраза) без ссылки отписки

• E20: ссылки с обычным http:// вместо https://

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным подходом для каждого правила

• Примеры шаблонов с ошибками и их исправленные версии для вымышленной кофейни (рассылка, объявление кафе, листовка к Чёрной пятнице, длинный каталог, приветственное письмо MJML и сброс пароля), а также реальный отчёт сканера для шаблонов с ошибками

Ограничения

Сканер проверяет каждый шаблон в исходном виде. Он не подставляет значения в теги, не выполняет циклы и не подключает фрагменты, поэтому итоговое письмо, отправляемое платформой (со ссылками отслеживания, циклами товаров и собственным подвалом), может быть больше файла, а всё, что поступает из переменных, не проверяется. Подвалы, ссылки отписки, адреса и текст предпросмотра, добавляемые платформой вне шаблона, не видны. Отличие рекламных писем от транзакционных определяется предположительно по именам и словам. Сканер не отображает письмо, поэтому цвета, тёмная тема и отображение в разных почтовых приложениях не проверяются. Это не юридическая консультация, а статус НЕ ОТМЕЧЕНО не гарантирует доставку.

Содержимое архива

Один ZIP-архив с 18 файлами: SKILL.md, сканер в scripts/ (3 файлов Python), references/rules.md (все правила с обоснованием и более безопасным подходом), а также examples/ (12 файлов примеров и report.md, реальный результат сканирования примера с уязвимостями).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для разработки, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты можно запускать и отдельно с Python 3.9 или новее, без установки дополнительных компонентов. Они только читают ваши файлы: не обращаются к сети и ничего никуда не отправляют.