activecampaign/postmark-skills/postmark-email-best-practices

Claude Code and agent skill by activecampaign/postmark-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when asking about email deliverability, compliance (CAN-SPAM, GDPR, CASL), transactional email design patterns, list management, testing safely, or general email best practices — provider-agnostic knowledge with Postmark-specific guidance.

Install

npx vskill@latest install activecampaign/postmark-skills/postmark-email-best-practices

SKILL.md

Email Best Practices

Postmark has delivered billions of transactional emails over 15+ years. This skill distills that expertise into actionable guidelines for building reliable, compliant, high-deliverability email systems.

Quick Reference

TopicUse When
DeliverabilitySetting up SPF/DKIM/DMARC, warming a new domain, diagnosing delivery issues
ComplianceBuilding unsubscribe flows, handling GDPR/CAN-SPAM/CASL requirements
Transactional DesignDesigning welcome emails, password resets, receipts, alerts
List ManagementHandling bounces, suppressions, list hygiene
TestingTesting safely without hurting sender reputation
Sending ReliabilityIdempotency, retry logic, rate limits

Deliverability Fundamentals

The three authentication records every sending domain must have:

RecordPurposePriority
SPFAuthorizes servers to send as your domainRequired
DKIMCryptographically signs emails to prove authenticityRequired
DMARCPolicy for handling SPF/DKIM failuresRequired

With Postmark, DKIM is configured automatically when you verify a sender domain. SPF and DMARC must be set up in your DNS.

See references/deliverability.md for DNS setup, reputation factors, and domain warm-up guidance.

Transactional vs. Broadcast Email

Never mix transactional and broadcast email in the same sending stream. They have different delivery characteristics, compliance requirements, and reputation profiles.

TypeExamplesComplianceUnsubscribe Required
TransactionalPassword resets, receipts, alerts, notificationsCAN-SPAM exemption possibleNo (but good practice)
BroadcastNewsletters, promotions, announcementsCAN-SPAM, GDPR, CASL applyYes — legally required

Postmark enforces this separation with Message Streams — use outbound for transactional, broadcast for marketing.

See references/compliance.md for CAN-SPAM, GDPR, and CASL requirements.

Transactional Email Design

Good transactional emails are:

  • Expected — The recipient triggered this email
  • Timely — Sent immediately after the triggering event
  • Actionable — One clear call to action
  • Plain — Minimal design; content over decoration

Common transactional email types and their essential elements:

Email TypeMust IncludeAvoid
WelcomeProduct name, next step CTA, support contactMarketing upsell on day 1
Password resetExpiry time, ignore-if-not-you notice, support linkLong copy
Receipt / InvoiceLine items, total, billing address, supportPromotional content
Shipping notificationTracking link, estimated delivery, itemsUnrelated promotions
Security alertWhat happened, when, action required, how to securePanic-inducing language

See references/transactional-design.md for design patterns, copy guidelines, and HTML email best practices.

List Health

Sending to invalid, inactive, or unengaged addresses is the leading cause of deliverability problems.

Key rules:

  • Remove hard bounces immediately and permanently
  • Suppress spam complaints immediately — never re-add
  • Re-permission lists older than 12–18 months before mailing
  • Never purchase or rent email lists
  • Validate addresses at the point of collection

See references/list-management.md for suppression strategies, list hygiene schedules, and re-engagement workflows.

Testing Safely

Never test with real addresses at consumer providers (gmail.com, yahoo.com, etc.) — it damages sender reputation.

MethodHowUse For
API test tokenUse POSTMARK_API_TEST as your server tokenValidating API calls in CI/development
Black holeSend to test@blackhole.postmarkapp.comFunctional testing — appears in activity
Sandbox serverCreate a dedicated sandbox server in dashboardFull send pipeline without delivery
Bounce testinghardbounce@bounce-testing.postmarkapp.comTesting bounce webhook handlers

See references/testing.md for full testing setup and domain warm-up schedules.

Sending Reliability

Production email systems need idempotency keys, retry logic, and rate limit handling to avoid duplicate sends and silent failures.

See references/sending-reliability.md for idempotency patterns, retry strategies, and rate limit handling.

Notes

  • Postmark is purpose-built for transactional email — use it for triggered 1:1 emails, not bulk marketing
  • Deliverability is not just about authentication — it's about sending wanted email to engaged recipients
  • A single spam complaint from a real user is more damaging than 1,000 hard bounces
  • Monitor your bounce rate (keep below 2%) and spam complaint rate (keep below 0.04%)

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
31
7-day trend score
17

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/activecampaign/postmark-skills/postmark-email-best-practices/badge)](https://verified-skill.com/skills/activecampaign/postmark-skills/postmark-email-best-practices)

Something wrong with this skill or its page? Tell us.