Skip to content
Back to search

email-best-practices

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/resend-email-best-practices/badge.svg)](/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

i

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)

  1. ---
  2. name: email-best-practices
  3. 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.
  4. license: MIT
  5. metadata:
  6. author: Resend
  7. version: "1.0.2"
  8. homepage: https://resend.com/agent-skills
  9. source: https://github.com/resend/email-best-practices
  10. openclaw:
  11. links:
  12. repository: https://github.com/resend/email-best-practices
  13. documentation: https://resend.com/docs/email-best-practices-skill
  14. ---
  15. # Email Best Practices
  16. Guidance for building deliverable, compliant, user-friendly emails.
  17. ## Architecture Overview
  18. ```
  19. [User] → [Email Form] → [Validation] → [Double Opt-In]
  20. ↓
  21. [Consent Recorded]
  22. ↓
  23. [Suppression Check] ←──────────────[Ready to Send]
  24. ↓
  25. [Idempotent Send + Retry] ──────→ [Email API]
  26. ↓
  27. [Webhook Events]
  28. ↓
  29. ┌────────┬────────┬─────────────┐
  30. ↓ ↓ ↓ ↓
  31. Delivered Bounced Complained Opened/Clicked
  32. ↓ ↓
  33. [Suppression List Updated]
  34. ↓
  35. [List Hygiene Jobs]
  36. ```
  37. ## Quick Reference
  38. | Need to... | See |
  39. |------------|-----|
  40. | Set up SPF/DKIM/DMARC, fix spam issues | [Deliverability](./references/deliverability.md) |
  41. | Build password reset, OTP, confirmations | [Transactional Emails](./references/transactional-emails.md) |
  42. | Plan which emails your app needs | [Transactional Email Catalog](./references/transactional-email-catalog.md) |
  43. | Build newsletter signup, validate emails | [Email Capture](./references/email-capture.md) |
  44. | Send newsletters, promotions | [Marketing Emails](./references/marketing-emails.md) |
  45. | Ensure CAN-SPAM/GDPR/CASL compliance | [Compliance](./references/compliance.md) |
  46. | Decide transactional vs marketing | [Email Types](./references/email-types.md) |
  47. | Handle retries, idempotency, errors | [Sending Reliability](./references/sending-reliability.md) |
  48. | Process delivery events, set up webhooks | [Webhooks & Events](./references/webhooks-events.md) |
  49. | Manage bounces, complaints, suppression | [List Management](./references/list-management.md) |
  50. | Make emails accessible (screen readers, alt text, contrast) | [Accessibility](./references/accessibility.md) |
  51. ## Start Here
  52. **New app?**
  53. 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.
  54. **Spam issues?**
  55. Check [Deliverability](./references/deliverability.md) first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.
  56. **Marketing emails?**
  57. 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).
  58. **Production-ready sending?**
  59. 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).
  60. **Accessibility?**
  61. 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)

  1. ```
  2. ╔══════════════════════════════════════╗
  3. ║ _____ __ __ _ ___ _ ║
  4. ║ | ____| \/ | / \ |_ _| | ║
  5. ║ | _| | |\/| | / _ \ | || | ║
  6. ║ | |___| | | |/ ___ \ | || |___ ║
  7. ║ |_____|_| |_/_/ \_\___|_____| ║
  8. ║ ║
  9. ║ Best Practices ║
  10. ╚══════════════════════════════════════╝
  11. ```
  12. # Email Best Practices Skill
  13. 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.
  14. ## Installation
  15. ```bash
  16. npx skills add resend/email-best-practices
  17. ```
  18. ## What This Skill Covers
  19. **Getting Started**
  20. - Planning which emails your app needs (password reset, verification, order confirmations)
  21. - Setting up email authentication (SPF, DKIM, DMARC) so emails reach inboxes
  22. **Sending Emails**
  23. - Transactional email design (subject lines, content structure, mobile-first)
  24. - Marketing email best practices (consent, segmentation, unsubscribe)
  25. - Compliance requirements by region (CAN-SPAM, GDPR, CASL)
  26. **Production Infrastructure**
  27. - Idempotency and retry logic to prevent duplicates
  28. - Webhook processing for delivery events
  29. - Suppression lists and list hygiene automation
  30. ## Structure
  31. ```
  32. email-best-practices/
  33. ├── SKILL.md # Start here - routes to the right resource
  34. └── references/
  35. ├── deliverability.md # SPF/DKIM/DMARC, sender reputation
  36. ├── transactional-emails.md # Password resets, OTPs, confirmations
  37. ├── transactional-email-catalog.md # Email combinations by app type
  38. ├── marketing-emails.md # Newsletters, campaigns, consent
  39. ├── email-capture.md # Validation, verification, opt-in
  40. ├── compliance.md # CAN-SPAM, GDPR, CASL
  41. ├── email-types.md # Transactional vs marketing
  42. ├── sending-reliability.md # Idempotency, retry logic, errors
  43. ├── webhooks-events.md # Delivery events, webhook setup
  44. └── list-management.md # Suppression lists, hygiene
  45. ```
  46. ## Quick Start
  47. Open `SKILL.md` - it has a routing table that directs you to the right resource based on what you need to do.
  48. ## License
  49. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.