mirror of
https://github.com/resend/email-best-practices.git
synced 2026-09-14 14:39:27 +08:00
main
╔══════════════════════════════════════╗
║ _____ __ __ _ ___ _ ║
║ | ____| \/ | / \ |_ _| | ║
║ | _| | |\/| | / _ \ | || | ║
║ | |___| | | |/ ___ \ | || |___ ║
║ |_____|_| |_/_/ \_\___|_____| ║
║ ║
║ Best Practices ║
╚══════════════════════════════════════╝
Email Best Practices Skill
A comprehensive agent skill for building production-ready email systems. Covers everything from DNS authentication to webhook processing, with a focus on deliverability, compliance, and reliability.
Installation
npx skills add resend/email-best-practices
What This Skill Covers
Getting Started
- Planning which emails your app needs (password reset, verification, order confirmations)
- Setting up email authentication (SPF, DKIM, DMARC) so emails reach inboxes
Sending Emails
- Transactional email design (subject lines, content structure, mobile-first)
- Marketing email best practices (consent, segmentation, unsubscribe)
- Compliance requirements by region (CAN-SPAM, GDPR, CASL)
Production Infrastructure
- Idempotency and retry logic to prevent duplicates
- Webhook processing for delivery events
- Suppression lists and list hygiene automation
Structure
email-best-practices/
├── SKILL.md # Start here - routes to the right resource
└── references/
├── deliverability.md # SPF/DKIM/DMARC, sender reputation
├── transactional-emails.md # Password resets, OTPs, confirmations
├── transactional-email-catalog.md # Email combinations by app type
├── marketing-emails.md # Newsletters, campaigns, consent
├── email-capture.md # Validation, verification, opt-in
├── compliance.md # CAN-SPAM, GDPR, CASL
├── email-types.md # Transactional vs marketing
├── sending-reliability.md # Idempotency, retry logic, errors
├── webhooks-events.md # Delivery events, webhook setup
└── list-management.md # Suppression lists, hygiene
Quick Start
Open SKILL.md - it has a routing table that directs you to the right resource based on what you need to do.
License
MIT
Description
Use when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring…
Languages
Markdown
100%