email-best-practices — скилл
Практики почты для агента: SPF, DKIM и DMARC, транзакционные и маркетинговые письма, повторы отправки, вебхуки и списки подавления
- 146 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл содержит только справочники, ничего не запускает и не отправляет письма.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/email-best-practicesОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл содержит только справочники, ничего не запускает и не отправляет письма.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
email-best-practices — официальный скилл Resend с рекомендациями по построению почтовой части приложения. В `SKILL.md` лежит таблица маршрутов: по задаче агент открывает нужный справочник из папки `references`. Всего их одиннадцать: доставляемость, транзакционные письма, каталог писем по типам приложений, маркетинговые рассылки, сбор адресов, соответствие закону, различие транзакционных и маркетинговых писем, надежность отправки, вебхуки, управление списками и доступность писем. В доставляемости разобраны записи SPF, DKIM и DMARC, репутация отправителя, прогрев IP и работа с отказами и жалобами. Раздел про надежность объясняет ключи идемпотентности, повторы с экспоненциальной паузой и коды ошибок. Для вебхуков описаны события, проверка подписи и идемпотентная обработка. Правовой справочник охватывает CAN-SPAM, GDPR и CASL, а также Великобританию и Бразилию. Скилл не привязан к Resend: рекомендации применимы к любому почтовому провайдеру. В репозитории есть и пять тестовых сценариев, например по спаму, повторной отправке и обработке отказов.
Для кого. Бэкенд-разработчикам и владельцам продуктов, которые строят отправку писем с нуля или ищут причину, почему письма попадают в спам.
Подходит, если
- Письма с подтверждением и сбросом пароля уходят в спам, и надо проверить записи SPF, DKIM и DMARC.
- Приложению нужен перечень писем: регистрация, чек, сброс пароля, уведомления, и агент подбирает набор под тип продукта.
- Отправка падает по сети, и надо добавить повторы так, чтобы клиент не получил два одинаковых письма.
- Нужно принимать события о доставке, отказах и жалобах и вести список подавления адресов.
- Рассылку по подписчикам из ЕС и Канады готовят с учетом GDPR и CASL, согласия и отписки.
Не подходит, если
- Нужны правила для российской рассылки: законы 38-ФЗ и 152-ФЗ в справочниках не разбираются.
- Требуется готовый API отправки или интеграция с конкретным сервисом: скилл дает практики и код-примеры, а не клиентскую библиотеку.
- Нужно оформить макет письма: вопросы верстки в скилле затронуты только через доступность.
Пример запроса к агенту
Письма с подтверждением регистрации попадают в спам. Проверь наш домен по списку доставляемости и скажи, какие записи DNS исправить.Ограничения
Справочники написаны на английском и привязаны к правилам США, ЕС, Канады, Великобритании и Бразилии, российские нормы о рекламных рассылках и персональных данных в них не рассмотрены. Юридические разделы дают общие ориентиры и не заменяют консультацию юриста. Примеры иногда используют Resend, хотя принципы одинаковы для любого провайдера. Скилл ничего не отправляет и DNS не меняет. Записи SPF, DKIM и DMARC агент составляет, а вносит человек у регистратора домена.
Как отключить. Удалите папку `email-best-practices` из каталога скиллов агента. Больше ничего устанавливать или откатывать не нужно.
Частые вопросы
Как поставить email-best-practices в Claude Code?
Выполните `npx skills add resend/email-best-practices` в корне проекта. После перезапуска агента скилл срабатывает на запросы про спам, отказы, SPF, DKIM, DMARC и вебхуки.
Нужен ли для скилла аккаунт Resend?
Нет. Скилл состоит из справочников и работает с любым провайдером почты. Аккаунт Resend нужен только для отдельных скиллов и API этой компании.
Что делать, если письма попадают в спам?
Открыть справочник `deliverability.md`: в нем проверка записей SPF, DKIM и DMARC, прогрев IP и работа с жалобами. Проблемы аутентификации там названы самой частой причиной.
Как не отправить одно письмо дважды при повторе?
Справочник `sending-reliability.md` описывает ключи идемпотентности и повторы с экспоненциальной паузой. Ключ строят из бизнес-события, например номера заказа, и повтор в пределах 24 часов вернет прежний ответ вместо нового письма.
Охватывает ли скилл российское законодательство?
Нет. В разделе про соответствие закону разобраны CAN-SPAM, GDPR, CASL и несколько других стран, а требования российских законов о рекламе и персональных данных нужно проверять отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкиллы Resend
Resend Skills
Официальные скиллы Resend для отправки и приема писем, React Email и CLI, плюс удаленный MCP с доступом ко всему API
Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.
Upstash Redis SDK
redis-js
Справочник по SDK @upstash/redis для агента: структуры данных, кэш, лимиты запросов, блокировки и полнотекстовый поиск
builder-skills — скиллы для приложений на Convex
builder-skills
17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений
Три скилла для бэкенда: агент защищает доступ, данные и миграции схемы, критических ошибок стало 2 из 150 запусков вместо 25.
Скилл Payload
Payload agent skill
Официальный скилл Payload CMS, который приходит вместе с пакетом: коллекции, поля, хуки, доступы, запросы и адаптеры баз данных
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| email-best-practices (эта карточка) | нет | 146 | ||
| Скиллы Resend | нет | API-ключ | 212 | набор из пяти скиллов Resend с API, CLI и MCP; здесь отдельный справочник по доставляемости и надежности без привязки к сервису |
| Resend CLI | да | 411 | консольная утилита `resend` для отправки писем и управления доменами; здесь только руководство, ничего не запускающее |
Коротко о README
Документация коротко перечисляет, что покрывает скилл: планирование писем, аутентификацию, отправку, соответствие закону и устойчивую инфраструктуру с идемпотентностью, вебхуками и списками подавления. Показана структура папок и лицензия MIT.