skills.rest
divinaarmuela
divinaarmuelaCOMMUNITY
Explore all skills by this author →
GitHub

email-best-practices

Guides implementation of deliverable, compliant, and accessible transactional and marketing emails.

Updated Apr 19, 2026
Search Tags:#accessibility#compliance#email#webhooks#deliverability#transactional emails#spf dkim dmarc
One-click install
npx skills add https://github.com/divinaarmuela/Content --skill email-best-practices-divinaarmuela
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: email-best-practices
Source: https://github.com/divinaarmuela/Content/tree/main/.claude/skills/email-best-practices
Command: npx skills add https://github.com/divinaarmuela/Content --skill email-best-practices-divinaarmuela

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building email features involves many failure points: messages landing in spam, missing SPF/DKIM/DMARC authentication, legal violations under CAN-SPAM/GDPR/CASL, duplicate sends from retries, and inaccessible templates that screen readers cannot parse. This Skill provides structured guidance across the entire email lifecycle. ## Core Features & Use Cases - Deliverability & Authentication: Set up SPF, DKIM, and DMARC records, warm up sending IPs, and troubleshoot spam placement with diagnostic tools. - Compliance & Consent: Implement double opt-in capture flows, consent records, List-Unsubscribe headers, and region-specific legal requirements (CAN-SPAM, GDPR, CASL). - Sending Reliability: Apply idempotency keys, exponential backoff retries, webhook signature verification, and suppression list management for bounces and complaints. - Use Case: You are launching a SaaS app and need password resets, order receipts, and a newsletter. Use the transactional email catalog to plan required emails, configure DNS authentication before sending, then add webhook handlers to suppress bounced addresses automatically. ## Quick Start Ask the agent to help you set up SPF, DKIM, and DMARC authentication for your domain and plan the transactional emails your app needs.

Frequently Asked Questions about email-best-practices

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

FAQPage Schema
How do I set up SPF, DKIM, and DMARC for my domain?▼

Add an SPF TXT record listing your sending servers, publish the DKIM TXT record provided by your email service, and create a DMARC record starting with p=none for monitoring. Verify each with dig TXT commands before sending.

Why are my emails going to spam?▼

Spam placement is most commonly caused by missing SPF, DKIM, or DMARC authentication, which Gmail and Yahoo now require. Also check for a missing List-Unsubscribe header, poor sender reputation, and sudden volume spikes.

What is the difference between transactional and marketing emails?▼

Transactional emails facilitate a user-initiated action like password resets or receipts and can be sent without opt-in. Marketing emails are promotional, require explicit consent, and must include an unsubscribe mechanism.

How do I prevent duplicate emails when retrying failed sends?▼

Send a deterministic idempotency key derived from the business event, such as order-confirm-{orderId}, with each request. The server returns the original response for repeated keys instead of sending again, typically within a 24-hour window.

Does GDPR require double opt-in for newsletters?▼

GDPR requires explicit, freely given opt-in consent, and double opt-in is the recommended way to prove it. Pre-checked boxes and assumed consent from purchases do not qualify as valid consent.

How should I handle bounced and complained email addresses?▼

Add hard bounces and spam complaints to a suppression list immediately via webhook events and never send to them again. Suppress soft bounces after about three failures, and check the suppression list before every send.

Related Skills

Explore More Software Engineering Skills→
theslashdojotheslashdojo

domains

Manage and verify Resend sending domains and their DNS records.

Official
Intermediate
ohsonerdyohsonerdy

email-marketing

Audit ecomm email list health, deliverability, and segmentation cadence.

Community
Advanced
myapihqmyapihq
83

my-webhook-api

Captures inbound HTTP webhook deliveries and stores payloads for inspection and automation workflows.

Official
Intermediate
devkit-stackdevkit-stack

email-best-practices

Configure SPF, DKIM, and DMARC for email deliverability and compliance.

Official
Intermediate