Email Best Practices

What it does

Comprehensive guidance for engineers building email features. Covers DNS authentication (SPF/DKIM/DMARC), deliverability troubleshooting, transactional vs marketing email design, capture/consent flows, webhook handling, idempotent sending and retry logic, bounce and suppression handling, and legal compliance (CAN-SPAM, GDPR, CASL). Includes reference documents for common tasks so engineers can follow checklists and examples.

When to use it

Use this skill when implementing or debugging email sending in an app: setting up SPF/DKIM/DMARC; reducing spam and bounce rates; designing password reset, OTP, or transactional flows; building marketing campaigns safely; or wiring webhooks and delivery-event processors. Also useful for planning list hygiene jobs and suppression handling.

What's included

• Scripts: none (has_references=true) — rich references/ documentation folder with step-by-step guides (deliverability, transactional catalog, webhooks, compliance).
• References: Deliverability, Transactional Emails, Email Capture, Marketing Emails, Compliance, Sending Reliability, Webhooks & Events, List Management.
• Instructions: architecture overview, quick-reference table mapping needs to reference docs, and practical start/repair guidance for new apps or spam issues.

Compatible agents

Designed for general-purpose assistant agents and coding assistants that provide engineering guidance (Claude, Codex, OpenClaw sessions, GPT-family).