https://github.com/resend/email-best-practices
Best practices for building and sending emails aided by agents.
https://github.com/resend/email-best-practices
Last synced: 5 months ago
JSON representation
Best practices for building and sending emails aided by agents.
- Host: GitHub
- URL: https://github.com/resend/email-best-practices
- Owner: resend
- Created: 2026-01-22T19:00:57.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-23T17:28:53.000Z (5 months ago)
- Last Synced: 2026-01-24T06:34:24.255Z (5 months ago)
- Size: 55.7 KB
- Stars: 30
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
```
╔══════════════════════════════════════╗
║ _____ __ __ _ ___ _ ║
║ | ____| \/ | / \ |_ _| | ║
║ | _| | |\/| | / _ \ | || | ║
║ | |___| | | |/ ___ \ | || |___ ║
║ |_____|_| |_/_/ \_\___|_____| ║
║ ║
║ 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
```bash
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
└── resources/
├── 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