email-deliverability
Installation
SKILL.md
Email Deliverability
Workflow
- Capture the complete SMTP rejection/DSN and authentication headers from a delivered sample when available.
- Identify the actual egress MTA/relay and public IP from sockets, containers, relay configuration and headers.
- Classify the failure layer before changing authentication: a TCP timeout before SMTP banner is a reachability incident, while an SMTP policy response proves a session was established far enough to receive that response.
- Verify forward/reverse DNS, HELO/EHLO, TLS, envelope/header domains and alignment.
- Validate SPF, every DKIM signature/selector and DMARC policy/alignment. Never create multiple SPF policies for one hostname; merge authorized mechanisms into one valid policy.
- Classify SMTP-level failures as authentication/identity, reputation, rate/throttling, content, recipient or provider policy using the exact response text.
- Compare behavior with current provider requirements before changing infrastructure.
- Change one causal variable at a time and retest. Treat relay acceptance (
250) separately from final inbox placement.
Routing boundaries
- DNS/TCP timeout or refusal before banner →
smtp-production-debugging. - Persistent failures clustered by destination MX/IP →
smtp-production-debugging. - Known problematic destination requiring an alternate Postfix transport →
postfix-selective-relay. - Local/container Postfix service, queue or config issue →
postfix-billionmail. - SPF/DKIM/DMARC, reputation, spam placement, provider bulk-sender policy → continue here.