email-practices

Installation
SKILL.md

Email practices

An email reaches the inbox when the sending domain is authenticated (SPF, DKIM and DMARC aligned with the From: domain), the recipients asked for it, and the sender's spam complaint rate stays low; Gmail, Yahoo and Microsoft now reject or spam-filter mail that misses those rules, and authentication problems are the most common cause of mail in spam. The pipeline this skill follows runs from the email form through validation, double opt-in and recorded consent, a suppression check, an idempotent send with retries, and webhook events (delivered, bounced, complained) that feed the suppression list and hygiene jobs. For Resend's SDK, domains, contacts, broadcasts and inboxes read resend SKILL.md; for building templates read react-email SKILL.md. Sequence planning, lifecycle programs and campaign copy live in email-marketing; writing cold outreach is in cold-outreach SKILL.md, and only its law lives here.

Apply only the routes and checks for the selected job. Read a linked skill's named file from its installed folder when available, or from the linked source. Report an unavailable required reference instead of inventing it. [skill-authoring, DISTRIBUTION.md#composing-skills]

The job Read
SPF, DKIM, DMARC (RFC 7489 and RFC 9989 tags, alignment, rollout), Gmail, Yahoo and Outlook.com sender requirements with dates and thresholds, Gmail error codes, warm-up, bounce and complaint rates, stop-loss rules, PTR and TLS, display names, spam debugging, why opens mislead DELIVERABILITY.md
CAN-SPAM, GDPR, CASL, PECR, TCPA and other laws, cold and unsolicited email (B2B scope, ePrivacy, GDPR Art. 14 and 21, CASL s.10(9), Germany, Australia), unsubscribe deadlines, List-Unsubscribe (RFC 2369), one-click (RFC 8058), what Gmail and Yahoo check, the unsubscribe endpoint, preference centers, consent records, retention, privacy policy COMPLIANCE.md
Transactional versus marketing, keeping them apart, legal rules by type, the transactional catalog by app type, what each email contains, subject lines, sender settings, OTP and button design EMAIL-TYPES.md
Capturing addresses, validation, double opt-in, consent checkboxes, the suppression list across channels, hygiene and re-engagement, retention periods LISTS-AND-CAPTURE.md
Idempotency keys, what to retry, backoff, error handling, a queue for critical mail, timeouts, delivery events, the webhook endpoint, bounce and complaint handlers, webhook retries RELIABILITY.md
lang and dir, layout tables, headings, link text, alt text, the title tag, contrast and dark mode, plain text, React Email defaults, testing ACCESSIBILITY.md

The rules

Installs
16
GitHub Stars
14
First Seen
Oct 17, 2026