Agent Skills › novuhq/novu › email-best-practices

email-best-practices

GitHub

提供电子邮件功能的开发最佳实践，涵盖发送可靠性、合规性（GDPR/CAN-SPAM）、反垃圾邮件认证（SPF/DKIM/DMARC）及列表管理。指导解决投递问题、构建事务性或营销邮件流程。

.agents/skills/email-best-practices/SKILL.md novuhq/novu

Trigger Scenarios

需要设置 SPF/DKIM/DMARC 以解决垃圾邮件问题构建密码重置或验证码等事务性邮件功能设计新闻订阅注册及合规性检查流程处理邮件发送重试、幂等性及 Webhook 回调

Install

npx skills add novuhq/novu --skill email-best-practices -g -y

More Options

Non-standard path

npx skills add https://github.com/novuhq/novu/tree/next/.agents/skills/email-best-practices -g -y

Use without installing

npx skills use novuhq/novu@email-best-practices

指定 Agent (Claude Code)

npx skills add novuhq/novu --skill email-best-practices -a claude-code -g -y

安装 repo 全部 skill

npx skills add novuhq/novu --all -g -y

预览 repo 内 skill

npx skills add novuhq/novu --list

SKILL.md

Frontmatter

{
    "name": "email-best-practices",
    "description": "Use when building email features, emails going to spam, high bounce rates, setting up SPF\/DKIM\/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM, GDPR, CASL), handling webhooks, retry logic, or deciding transactional vs marketing."
}

Email Best Practices

Guidance for building deliverable, compliant, user-friendly emails.

Architecture Overview

[User] → [Email Form] → [Validation] → [Double Opt-In]
                                              ↓
                                    [Consent Recorded]
                                              ↓
[Suppression Check] ←──────────────[Ready to Send]
        ↓
[Idempotent Send + Retry] ──────→ [Email API]
                                       ↓
                              [Webhook Events]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         Delivered  Bounced  Complained  Opened/Clicked
                       ↓        ↓
              [Suppression List Updated]
                       ↓
              [List Hygiene Jobs]

Quick Reference

Need to...	See
Set up SPF/DKIM/DMARC, fix spam issues	Deliverability
Build password reset, OTP, confirmations	Transactional Emails
Plan which emails your app needs	Transactional Email Catalog
Build newsletter signup, validate emails	Email Capture
Send newsletters, promotions	Marketing Emails
Ensure CAN-SPAM/GDPR/CASL compliance	Compliance
Decide transactional vs marketing	Email Types
Handle retries, idempotency, errors	Sending Reliability
Process delivery events, set up webhooks	Webhooks & Events
Manage bounces, complaints, suppression	List Management

Start Here

New app? Start with the Catalog to plan which emails your app needs (password reset, verification, etc.), then set up Deliverability (DNS authentication) before sending your first email.

Spam issues? Check Deliverability first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.

Marketing emails? Follow this path: Email Capture (collect consent) → Compliance (legal requirements) → Marketing Emails (best practices).

Production-ready sending? Add reliability: Sending Reliability (retry + idempotency) → Webhooks & Events (track delivery) → List Management (handle bounces).