email-best-practices
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, making emails accessible (alt text, headings, contrast, screen readers), or deciding transactional vs marketing.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/resend-email-best-practices)HTML
<a href="/listings/resend-email-best-practices"><img src="/api/listings/resend-email-best-practices/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills add resend/email-best-practices
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 73 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- 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, making emails accessible (alt text, headings, contrast, screen readers), or deciding transactional vs marketing.
- license: MIT
- metadata:
- author: Resend
- version: "1.0.2"
- homepage: https://resend.com/agent-skills
- source: https://github.com/resend/email-best-practices
- openclaw:
- links:
- repository: https://github.com/resend/email-best-practices
- documentation: https://resend.com/docs/email-best-practices-skill
- ---
- # 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](./references/deliverability.md) |
- | Build password reset, OTP, confirmations | [Transactional Emails](./references/transactional-emails.md) |
- | Plan which emails your app needs | [Transactional Email Catalog](./references/transactional-email-catalog.md) |
- | Build newsletter signup, validate emails | [Email Capture](./references/email-capture.md) |
- | Send newsletters, promotions | [Marketing Emails](./references/marketing-emails.md) |
- | Ensure CAN-SPAM/GDPR/CASL compliance | [Compliance](./references/compliance.md) |
- | Decide transactional vs marketing | [Email Types](./references/email-types.md) |
- | Handle retries, idempotency, errors | [Sending Reliability](./references/sending-reliability.md) |
- | Process delivery events, set up webhooks | [Webhooks & Events](./references/webhooks-events.md) |
- | Manage bounces, complaints, suppression | [List Management](./references/list-management.md) |
- | Make emails accessible (screen readers, alt text, contrast) | [Accessibility](./references/accessibility.md) |
- ## Start Here
- **New app?**
- Start with the [Catalog](./references/transactional-email-catalog.md) to plan which emails your app needs (password reset, verification, etc.), then set up [Deliverability](./references/deliverability.md) (DNS authentication) before sending your first email.
- **Spam issues?**
- Check [Deliverability](./references/deliverability.md) first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.
- **Marketing emails?**
- Follow this path: [Email Capture](./references/email-capture.md) (collect consent) → [Compliance](./references/compliance.md) (legal requirements) → [Marketing Emails](./references/marketing-emails.md) (best practices).
- **Production-ready sending?**
- Add reliability: [Sending Reliability](./references/sending-reliability.md) (retry + idempotency) → [Webhooks & Events](./references/webhooks-events.md) (track delivery) → [List Management](./references/list-management.md) (handle bounces).
- **Accessibility?**
- Most emails fail basic accessibility checks. See [Accessibility](./references/accessibility.md) for `lang`/`dir`, presentational tables, headings, alt text, `<title>`, and contrast.
README.md · README · 63 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ```
- ╔══════════════════════════════════════╗
- ║ _____ __ __ _ ___ _ ║
- ║ | ____| \/ | / \ |_ _| | ║
- ║ | _| | |\/| | / _ \ | || | ║
- ║ | |___| | | |/ ___ \ | || |___ ║
- ║ |_____|_| |_/_/ \_\___|_____| ║
- ║ ║
- ║ 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
- └── 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.