email-best-practices

Configure SPF, DKIM, and DMARC with idempotent retries and webhook processing.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/otto-poblysh/pedagemy-early-access --skill email-best-practices-otto-poblysh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email-best-practices
Source: https://github.com/otto-poblysh/pedagemy-early-access/tree/main/.agents/skills/email-best-practices
Command: npx skills add https://github.com/otto-poblysh/pedagemy-early-access --skill email-best-practices-otto-poblysh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you stop critical emails from being filtered as spam or rejected by focusing on deliverability (authentication and reputation), operational reliability (idempotency, retries), and legal compliance (consent and unsubscribe handling).

Core Features & Use Cases

  • Deliverability & authentication: Configure SPF, DKIM, and DMARC, verify DNS records with dig, and address common causes of spam placement.
  • Email design for inbox placement: Apply best practices for transactional vs marketing messaging, subject/preheader patterns, and mobile-first formatting.
  • Reliability for production sending: Implement idempotency keys, retry logic with exponential backoff, and safe timeouts/queuing for critical sends.
  • Webhook processing for delivery events: Handle delivery, bounces, and complaints via signed webhooks with idempotent event processing.
  • Compliance by region + list hygiene: Support CAN-SPAM, GDPR, and CASL requirements, maintain suppression lists, and manage retention/consent records.

Quick Start

Ask an agent to “Plan and implement production-ready email sending for my app: SPF, DKIM, DMARC, bounce/complaint webhook handling, suppression list strategy, idempotent retries, and CAN-SPAM/GDPR/CASL unsubscribe and consent record requirements.”

Frequently Asked Questions about email-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure SPF, DKIM, and DMARC for email deliverability?

Email deliverability requires SPF, DKIM, and DMARC DNS records to authenticate sending domains. You must configure these records, verify them with dig, and apply DMARC policies to stop emails from being filtered as spam or rejected.

What's the best way to handle email bounces and complaints via webhooks?

Handling email bounces and complaints requires processing signed webhooks with idempotent event processing and deduplication. This ensures reliable delivery tracking while safely managing suppression lists to prevent sending to invalid or complaining recipients.

How do I implement idempotency and retry logic for transactional email sending?

Transactional email sending reliability requires idempotency keys to prevent duplicate sends, retry logic with exponential backoff for failed deliveries, and safe timeouts with queuing to ensure critical messages reach recipients without causing system overloads.

Does my email system need CAN-SPAM, GDPR, and CASL compliance for marketing campaigns?

Marketing email systems must support CAN-SPAM, GDPR, and CASL compliance by managing region-specific consent records, processing unsubscribes, and maintaining suppression lists. Proper list hygiene and retention management ensure legal sending requirements are met.

Why does my transactional email go to spam despite having proper DNS authentication?

Transactional email goes to spam when deliverability thresholds are not met, requiring IP warming schedules and mobile-first formatting. Differences in transactional versus marketing design, subject lines, and preheader patterns also impact inbox placement.

Can I use a single email infrastructure for both transactional and marketing messages?

Transactional and marketing emails require different design patterns, compliance handling, and reputation management. Separating infrastructure or applying distinct sending rules ensures optimal inbox placement and appropriate consent management for each message type.