🎯

email-best-practices

🎯Skill

from samunderwood/agent-skills

What it does

Guides developers in building compliant, deliverable emails with best practices for validation, authentication, consent, and sending reliability.

📦

Part of

samunderwood/agent-skills(17 items)

email-best-practices

Installation

📋 No install commands found in docs. Showing default command. Check GitHub for actual instructions.

Quick InstallInstall with npx

npx skills add samunderwood/agent-skills --skill email-best-practices

Need more details? View full documentation on GitHub →

1Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

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, or deciding transactional vs marketing.

Overview

# 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](./resources/deliverability.md) |

| Build password reset, OTP, confirmations | [Transactional Emails](./resources/transactional-emails.md) |

| Plan which emails your app needs | [Transactional Email Catalog](./resources/transactional-email-catalog.md) |

| Build newsletter signup, validate emails | [Email Capture](./resources/email-capture.md) |

| Send newsletters, promotions | [Marketing Emails](./resources/marketing-emails.md) |

| Ensure CAN-SPAM/GDPR/CASL compliance | [Compliance](./resources/compliance.md) |

| Decide transactional vs marketing | [Email Types](./resources/email-types.md) |

| Handle retries, idempotency, errors | [Sending Reliability](./resources/sending-reliability.md) |

| Process delivery events, set up webhooks | [Webhooks & Events](./resources/webhooks-events.md) |

| Manage bounces, complaints, suppression | [List Management](./resources/list-management.md) |

Start Here

New app?

Start with the [Catalog](./resources/transactional-email-catalog.md) to plan which emails your app needs (password reset, verification, etc.), then set up [Deliverability](./resources/deliverability.md) (DNS authentication) before sending your first email.

Spam issues?

Check [Deliverability](./resources/deliverability.md) first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.

Marketing emails?

Follow this path: [Email Capture](./resources/email-capture.md) (collect consent) → [Compliance](./resources/compliance.md) (legal requirements) → [Marketing Emails](./resources/marketing-emails.md) (best practices).

Production-ready sending?

Add reliability: [Sending Reliability](./resources/sending-reliability.md) (retry + idempotency) → [Webhooks & Events](./resources/webhooks-events.md) (track delivery) → [List Management](./resources/list-management.md) (handle bounces).

More from this repository10

🎯

copywriting🎯Skill

Crafts persuasive marketing copy that converts by transforming product features into compelling customer-focused narratives across web pages.

🎯

frontend-design🎯Skill

Generates distinctive, production-grade frontend interfaces with creative design, transforming web components and applications into visually striking, memorable experiences.

🎯

next-upgrade🎯Skill

I apologize, but I cannot generate a description without seeing the actual code or having more context about the "next-upgrade" skill from the repository. Could you provide more details about what ...

🎯

send-email🎯Skill

Sends transactional and bulk emails via Resend API, supporting single and batch email approaches with robust error handling.

🎯

payload🎯Skill

Develops and debugs Payload CMS projects by managing collections, fields, hooks, access control, and API interactions with TypeScript-first approach.

🎯

next-best-practices🎯Skill

Streamlines and recommends best practices for Next.js projects, providing automated code quality and optimization suggestions.

🎯

find-skills🎯Skill

Discovers and recommends installable agent skills by searching the skills ecosystem when users need help with specific tasks or capabilities.

🎯

react-email🎯Skill

Generates React-based email templates with cross-client compatibility, enabling developers to create consistent, reusable transactional and marketing emails.

🎯

better-auth-best-practices🎯Skill

Securely manages authentication with TypeScript-first framework, supporting email/password, OAuth, magic links, and passkeys via flexible plugins.

🎯

resend🎯Skill

Enables seamless email operations using Resend platform, routing to specialized sub-skills for sending, receiving, and managing email workflows.