email-best-practices

Guides implementation of deliverable, compliant transactional and marketing email systems.

Updated Sep 1, 2021
One-click install
npx skills add https://github.com/WP-Coaching/pellegrims.coach --skill email-best-practices-wp-coaching
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email-best-practices
Source: https://github.com/WP-Coaching/pellegrims.coach/tree/main/.agents/skills/email-best-practices
Command: npx skills add https://github.com/WP-Coaching/pellegrims.coach --skill email-best-practices-wp-coaching

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building email features involves navigating deliverability rules, spam filtering, legal compliance (CAN-SPAM, GDPR, CASL), and reliability concerns that are easy to get wrong, leading to emails landing in spam or legal exposure. ## Core Features & Use Cases - Deliverability Setup: Configure SPF, DKIM, and DMARC DNS records, warm up sending IPs, and troubleshoot spam placement. - Compliance Guidance: Meet CAN-SPAM, GDPR, and CASL requirements for consent, unsubscribe handling, and data retention. - Sending Reliability: Implement idempotency keys, exponential backoff retries, webhook signature verification, and bounce/complaint suppression lists. - Use Case: When adding a password reset flow to your app, use this Skill to design the email content, set up domain authentication, add idempotent sending with retry logic, and process bounce webhooks to keep your list clean. ## Quick Start Use the email-best-practices skill to help me set up SPF, DKIM, and DMARC for my domain and design a compliant password reset email flow.

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, then roll DMARC from none to quarantine to reject.

What is the difference between transactional and marketing emails?

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

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 sender reputation, bounce rates above 4%, complaint rates above 0.05%, and sudden volume spikes.

How do I handle email bounces and complaints?

Add hard bounces and spam complaints to a suppression list immediately via webhook events, and never send to them again. Retry soft bounces on a 1h, 4h, 24h schedule and suppress after three to five failures.

How do I prevent duplicate emails when retrying failed sends?

Send a deterministic idempotency key based on the business event, such as password-reset-userId-requestId, with each request. Retries with the same key return the original response instead of sending a duplicate, typically within a 24-hour window.

Do I need double opt-in for newsletter signup?

Double opt-in is recommended for all marketing lists because it verifies deliverability, confirms intent, and reduces complaints. It is effectively required in some regions like Germany and helps meet GDPR and CASL consent standards.