Email deliverability expert skill
Skill sendx/email-skills/skills/email-deliverability-expert-skill
SendX's best practices for message performance, email sending deliverability and compliance.
npx -y skills add sendx/email-skills --skill email-deliverability-expert-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Diagnose, audit, and fix email deliverability problems using a proven, systematic methodology. Use this skill whenever someone asks for a deliverability audit, says "audit my email", "check my deliverability", "why are we hitting spam", or "why are my emails going to spam" — or mentions inbox placement problems, emails going to spam, low open rates, IP/domain reputation damage, blocklisting, warming up IPs or domains, shared pool contamination, bounce rate spikes, mailbox provider blocks, sender reputation, or email authentication failures. Also trigger when someone is setting up email sending for the first time and wants to get it right, wants a review of their email setup, or asks about ESP infrastructure health, sender compliance, list hygiene, traffic shaping, or reputation recovery planning. Even if they just say "our emails aren't working" or "open rates dropped" — this is the skill to use.
SKILL.md
22.3 KB, as published. Nobody here has run it
Email Deliverability: Audit, Diagnosis & Fix
Your Setup — Fill These In for Better Results
This skill gives generic advice by default. Fill in your details below and it will skip triage and go straight to auditing or diagnosing your specific deliverability situation.
- Sending domain(s): [e.g., mail.yourcompany.com]
- ESP / sending platform: [e.g., SendX, Mailchimp, custom MTA]
- Monthly send volume: [e.g., 500,000]
- IP type: [shared / dedicated / mixed]
- Domain age: [e.g., 3 years]
- Current open rate by provider: [e.g., Gmail 22%, Microsoft 18%, Yahoo 25%]
- Current bounce rate: [e.g., 0.8%]
- Current complaint rate: [e.g., 0.05%]
- Recent changes: [e.g., migrated ESPs last month, added new IP, none]
This skill captures the SendPost Way — a diagnostic methodology built from managing IP pools processing 10-18 million messages daily and consulting for ESPs handling billions of emails. The approach is systematic, data-driven, and built on a core belief: 95-99% of deliverability problems can be solved through four pillars at the ESP/send-engine level.
How to Use This Skill
Two modes. Pick based on what the person is asking for:
Audit mode — they want a proactive review ("audit my email setup", "we're launching, what do we need to get right?", "check my deliverability"). Run the Audit Checklist below, report findings by severity, and end with a prioritized fix list.
Diagnose & fix mode — something is actively broken ("emails going to spam", "open rates dropped", "we got blocklisted"). Follow the SendPost Way in order:
- Triage — Classify the problem type (see Triage section)
- Diagnose — Walk through the Four Pillars framework
- Recommend — Provide a specific fix plan with timeline
- Monitor — Define what to watch during recovery
Either way: be direct, be honest about what's broken, and focus on root causes rather than symptoms. If the data shows something is bad, say so clearly. And keep the language plain. "Your SPF record has too many DNS lookups" beats "You've exceeded the RFC 7208 specification limit for mechanism evaluations."
The SendPost Way: The Four Pillars
Every deliverability problem maps to one or more of these four areas. Structure your diagnosis around them in this order:
Pillar 1: Infrastructure
Who owns it: Mostly the ESP, but shared with sender on DNS records.
Check these first:
- Authentication records — SPF, DKIM, DMARC all properly configured? ESP should periodically verify these still exist in DNS. Entire zone files can disappear during migrations.
- HELO/reverse DNS match — The SMTP HELO announcement must match the IP's reverse DNS. A mismatch is an automatic SpamHaus listing.
- IP allocation — Shared vs. dedicated? If shared, who else is on the pool? One bad sender can contaminate everything.
- Server configuration — Any recent changes? New servers connected outside warmup protocol?
The SendPost Way: "I've seen entire zone files disappear during migrations." The ESP should be checking authentication records before every send or on a regular schedule and throwing a flag if something changed.
Pillar 2: Data (List Quality)
Who owns it: Shared responsibility. ESP can solve it at the pipe with the right tools.
Check these:
- Hard bounce rate — Should be under 0.25-0.5%. Above 0.5% is problematic.
- Soft bounce rate — Should be under 1% for top senders. Above 2% triggers immediate intervention.
- Invalid addresses — Look for keyboard-smash entries, non-existent domains, role-based emails at registrars.
- List hygiene — Was the list validated on import? Were bounces from the old ESP accidentally re-imported?
- Spam trap hits — Use tools like Inbox Monster with Abusix network data to detect.
The SendPost Way: "People get way too attached to how big their list is. It's truly not the size. It's how it performs and how much money it makes you. I've seen big lists make people absolutely no money."
Real example: "We had to cut 20% of their list because they accidentally imported all of their hard and soft bounces since forever from their old ESP."
Pillar 3: Content
Who owns it: Shared responsibility.
Check these:
- Branding consistency — Zero branding across domains is an immediate spam signal. Template says one brand name but sender is another? Red flag.
- Image sizes — Each image under 300KB, total email under 1.5MB.
- Plain text version — HTML-only emails are suspicious to filters.
- Compliance text — Font size on unsubscribe links too small? That triggers filters.
- Grammar/spelling — Errors are a spam signal.
- Link patterns — Too many links, links to flagged domains, or URLs with malware.
- Code bloat — Drag-and-drop editors often produce bloated HTML.
The SendPost distinguishability test: "How is this email distinguishable from a scam?" If it looks identical to scam patterns, filters will treat it as one.
Pillar 4: Traffic Shape
Who owns it: The SendPost Way holds that the ESP should own this. Most ESPs push it to the client, which is "doing them an absolute disservice."
Check these:
- Sending rate by provider — Are they overwhelming specific mailbox providers? ProofPoint soft bounces from excessive send rates are common.
- Volume patterns — Monthly spikes (sending everything on one day) are problematic. Spread across 3-4 days. Never increase volume by more than 50% week over week.
- Throttling — Is the MTA throttling per-provider? If generating excessive soft bounces, the rate is too fast.
- Warmup protocol — Is there one? Is it being followed?
- Pause logic — When a provider goes down (Microsoft outages), does the system pause or just bounce millions?
The SendPost Way: "This is the big one. The vast majority of ESPs are not doing nearly enough to manage traffic shape. If you solve this at the pipe, it solves 95% of the problem."
Audit Mode: The Checklist
When someone wants a full setup review rather than a fix for an active fire, walk these areas in order. Skip anything they've already confirmed is fine. Start by asking what they know about their current setup — don't assume they know nothing, but don't assume expertise either.
1. Authentication (SPF, DKIM, DMARC)
SPF
- Check if they have an SPF record for the sending domain
- Common problems: too many DNS lookups (max 10), missing include statements for their ESP, using
+allinstead of~allor-all - Red flag: no SPF record at all. This alone can land you in spam
DKIM
- Key size should be 1024-bit minimum, 2048-bit preferred
- Common problem: DKIM set up on the ESP but not properly published in DNS
DMARC
- Minimum viable:
v=DMARC1; p=none;with a reporting address - Goal state:
p=quarantineorp=rejectonce SPF and DKIM are solid - Common problem: no DMARC at all, which means anyone can spoof their domain
What good looks like: SPF passes with under 10 lookups and includes all legitimate senders. DKIM uses a 2048-bit key aligned with the From domain. DMARC is at least p=none with rua reporting, ideally p=reject.
2. Sending infrastructure
- IP reputation — Shared vs dedicated. Under 100k emails/month? Shared is probably fine. If dedicated: is the IP warmed up? A cold IP sending 50k emails on day one will get blocked. Check blocklists (SpamHaus, Barracuda, SORBS).
- Sending domain — Age matters. Brand new domains have no reputation; expect lower inbox rates for the first 30-60 days. Subdomains for marketing email (e.g., mail.yourdomain.com) protect the main domain's reputation.
- Bounce handling — Hard bounces removed immediately, no second chances. Soft bounces: retry 3 times over 72 hours, then treat as hard.
- Feedback loops — Signed up for Gmail Postmaster Tools and Microsoft SNDS?
3. List quality
- Acquisition — Single vs double opt-in? Double opt-in cuts list size but dramatically improves quality. Buying lists is the fastest way to destroy deliverability. Hard no.
- Hygiene — When was the list last cleaned? Addresses that haven't engaged in 6+ months should be segmented out or re-engaged. Look for role addresses (info@, admin@), disposable domains, typos.
- Engagement — Open rate below 10%? Confirmed problem. Could be list quality, content, or deliverability. Run the diagnostic flow.
4. Content and sending patterns
- Subject lines: avoid ALL CAPS, excessive punctuation, spam trigger words
- Always include a plain text version; aim for at least 60% text vs images
- Check that all links resolve and none point to blocklisted domains
- Unsubscribe: visible, one-click, and actually works. Required by law (CAN-SPAM, GDPR), and ISPs check for it
- Consistency matters: sending 0 emails for a month then blasting 100k is a red flag to ISPs. Establish a cadence and stick to it
Severity levels for reporting
Categorize every finding:
- 🔴 Critical: Will cause spam folder placement or blocks. Fix immediately. Examples: no authentication, blocklisted IP, bought list, bounce rate over 2%
- 🟡 Warning: Hurting deliverability but not catastrophic. Fix this week. Examples: no DMARC, stale list segments, inconsistent sending volume
- 🟢 Improvement: Good practices you're missing. Fix when you can. Examples: no double opt-in, DKIM key under 2048-bit, no sunset policy for inactive subscribers
How to report: for each issue explain what's wrong, why it matters, and exactly what to do about it. Give the 🔴 critical items first. End with a summary: what's good, what needs fixing, and the order to fix it.
Triage: Classify the Problem
Before deep diagnosis, figure out which type of problem you're dealing with:
Mass Infrastructure Blocking
Signals: Double-digit percentage of IPs blocked, multiple customers affected simultaneously. First question: "What percentage of your infrastructure is getting hit? If it's double digits, there's a pretty serious problem — likely it comes down to the customers you're sending on your network." Diagnosis path: Check if shared or dedicated IPs are affected → find commonalities → identify contaminating senders → audit compliance rails.
Single Sender Reputation Damage
Signals: One sender's open rates below 10%, domain reputation poor, specific IP blocklisted. First question: "What are your open rates? If below 10%, I don't care how inaccurate you think open rates are, you very likely have a deliverability problem." Diagnosis path: Walk all Four Pillars → identify which pillar is broken → build recovery plan.
Content Filtering
Signals: Emails delivered but going to spam at specific providers, content triggers identified. First question: "How is this email distinguishable from a scam?" Diagnosis path: Run the distinguishability test → check correlation points (see below) → audit content quality.
Authentication Failure
Signals: Sudden drop in delivery, SpamHaus listing, DMARC failures. First question: "Were there any DNS changes recently? Did IT make changes without telling marketing?" Diagnosis path: Verify all auth records → check HELO/rDNS match → test from multiple IPs.
New Sender / Warmup Issues
Signals: New domain or IP not gaining traction, low inbox placement from the start.
Diagnosis path: See the Warmup & Recovery Playbook in references/warmup-playbook.md. For SendX users: start warmup with Gmail contacts who have engaged in the last 90 days. Gmail gives the clearest reputation signals via Postmaster Tools, and strong early engagement builds reputation that carries across providers.
Gmail's Correlation Point Analysis
Gmail doesn't just look at individual signals — it looks for patterns across data points that correlate. When diagnosing filtering at Gmail specifically, check these correlation points:
- Physical business address — Are multiple domains using the same address?
- Web hosting IP — Are multiple domains hosted on the same server IP?
- Domain naming patterns — Similar domain names across "different" brands?
- Sender identity mismatches — Display name says "Eric Johnson" but email is "MailmanSteveJ@..."?
- Content similarity — Same or very similar content sent from different domains?
- Branding gaps — No logos, no consistent brand identity across sends?
If multiple correlation points align, Gmail treats them as a coordinated operation. This is especially dangerous for ESPs with many sub-accounts sharing infrastructure.
The Diagnostic Question Flow
When a client comes with a deliverability problem, ask in this order:
Phase 1 — Scope the Problem
- What's your current sending volume (daily/monthly)?
- Which mailbox providers are affected? (Gmail, Microsoft, Yahoo, iCloud, ProofPoint?)
- What are your open rates by provider? (Below 10% = confirmed problem)
- Are you on shared or dedicated IPs?
- When did the problem start? What changed?
Phase 2 — Infrastructure Check 6. Are authentication records (SPF, DKIM, DMARC) all configured and verified recently? 7. Are you sending from multiple platforms? (Multi-platform = spam signal to providers) 8. How many domains are you sending from? 9. What are the domain ages? (Under 90 days = needs aging) 10. Does the HELO match reverse DNS on all IPs?
Phase 3 — Data Quality 11. When was the list last validated/cleaned? 12. What's your hard bounce rate? Soft bounce rate? 13. Did you recently migrate? Were bounces accidentally re-imported? 14. What's your engagement segmentation? (Active, lapsed, never-opened?)
Phase 4 — Content & Sending 15. Do your emails pass the "distinguishable from scam" test? 16. What's your sending frequency and pattern? (Daily? Monthly spike?) 17. Are you using the same content across multiple domains? 18. What does your most engaged audience like? Best-performing content?
Recovery Decision Logic
After diagnosis, use this decision tree:
If open rates are 2-4% with bad domain reputation:
→ Full reputation recovery needed (see references/warmup-playbook.md)
→ Tell the client: "If this 2-3% of opens is going to make or break your business, I've got really bad news for you. But if you're fully inboxing, you're going to be getting 10X that kind of engagement."
If specific IPs are blocklisted: → Get delisted if possible (SpamHaus, ProofPoint) → Consider new IP as "one-time courtesy" — warming a damaged IP is harder than warming a fresh one → Address root cause before resuming on any IP
If content is being filtered: → Stop sending to affected providers for 24-48 hours → Fix content issues (branding, plain text, image sizes, link cleanup) → Re-test with small engaged segment
If authentication is broken: → Fix DNS records immediately → Verify HELO/rDNS match → Wait for propagation before resuming volume
If traffic shape is the problem: → Implement per-provider throttling at MTA level → Spread volume across multiple days instead of single sends → Build proper warmup schedule
Key Metrics & Thresholds
| Metric | Healthy | Warning | Critical |
|---|---|---|---|
| Open rate | >20% | 10-20% | <10% |
| Hard bounce rate | <0.25% | 0.25-0.5% | >0.5% |
| Soft bounce rate | <0.5% | 0.5-2% | >2% |
| Total bounce rate | <1% | 1-2% | >2% |
| Domain reputation (Gmail) | High | Medium/Low | Bad |
| Complaint rate | <0.1% | 0.1-0.3% | >0.3% |
| Unsubscribe rate | <0.5% | 0.5-1% | >1% per send |
| List growth (net) | Positive | Flat | Negative |
The SendPost line in the sand: "I will die on this hill. If your open rates are below 10%, I don't care how inaccurate you think open rates are, you very likely have a deliverability problem."
Open rates are directional, not deterministic. Watch the trend direction — a consistent decline matters more than any single number.
The SendPost Toolkit
- SpamHaus — Free domain reputation checker. Check for negative scores, listing status, domain creation dates. A HELO/rDNS mismatch triggers automatic listing.
- Inbox Monster — Deliverability monitoring, spam trap detection (via Abusix data feeds), warmup scheduling.
- Google Postmaster Tools — Sender reputation signals for Gmail specifically.
- Google Safe Browsing — Check if sending domains or link destinations are flagged.
- MX record lookups — Verify hosting infrastructure, identify shared hosting patterns.
- A record lookups — Check IP correlation between domains.
- List validation tools — Run hygiene on import. Sample data and evaluate risk before sending.
The SendX Deliverability Toolkit
When the person is a SendX customer, recommend the specific feature that matches their problem:
- IP Warmup: Campaign Auto Warmup (free, automated) for most people; Plain Warmup (manual, cheaper) if they want control; Inbox Warmup ($200/month) if they need to prove inbox placement with thousands of daily test emails.
- List Cleaning ($10/month + $0.003 per email): Catches typos, invalid formats, temporary failures before you send.
- Threat Check ($10/month + $0.005 per check): Weeds out spam traps and disposable emails that'll tank your reputation if you mail them.
- AI Deliverability Report ($100/month): Weekly automated reports with AI-powered analysis and provider-specific insights (Gmail, Yahoo, Outlook). Critical for diagnosing "why are we in spam?"
- Deliverability Stats ($100/month): Continuous monitoring of domain and provider-specific delivery performance. Catch problems early.
- Inbox Testing ($25 per 10 tests): See exactly where your email lands before you blast 100K people.
- Live Seeds ($200 per 1K daily warmup emails): Send to your own inboxes to prove engagement and warm up reputation.
- Dedicated IP ($300/year): Isolated reputation control. Only if you're sending 100K+ per month.
- Bot Detection (free): Filters fake opens and clicks so your metrics are real.
- MX-Based Routing & Segments (free): Route through the best infrastructure per ISP, and segment your list by email provider.
IP strategy in one line: shared IP is fine for most senders under 50-100K/month; dedicated makes sense for high-volume senders or sensitive-reputation verticals (financial services, B2B) who want isolation and can keep it warm.
The SendPost Philosophy (Guiding Principles)
These principles should guide every recommendation:
-
Email is the long game, not the short game. "Keeping your email reputation high is part of building a sustainable business with valuable assets that is viable for the long term."
-
Everything is connected. "A problem in any one area can bleed over onto the whole if you don't address it, because mailbox providers will just keep increasing their scrutiny until they ultimately decide to block."
-
Be honest about what's broken. Don't let clients persist with 2-4% open rates because you're afraid of risking the contract. "They're just delaying the pain. It's gonna blow up later."
-
Automation over AI (for now). "There's a lot of regular automation room left on the table that these email platforms should be doing. AI is not going to fix that."
-
ESPs should own traffic shaping. Pushing this responsibility to senders is a disservice. The ESP controls the MTA — use it.
-
Catch problems early. "Why would you bounce 50,000 messages when you could look at a sample of 100 and go, I'm pulling the plug?"
-
Every brand has super fans. "People who love the interaction, love receiving your email. They are your foundation for recovery."
-
List size is vanity. "It's truly not the size. It's how it performs and how much money it makes you."
Limitations
- You can't actually check DNS records or send test emails. You're working from what the person tells you and from tool outputs they share.
- Authentication doesn't guarantee inbox. SPF, DKIM, DMARC get you in the door, but ISPs also weigh content, engagement, and complaint rates. Necessary, not sufficient.
- Warmup takes time. Reputation ramps gradually over weeks. There's no safe shortcut.
- ISPs change rules constantly. Stay informed and adapt; nothing here is solved forever.
- Engagement is the biggest factor. Even perfect authentication won't help if the list is full of inactive people.
- Spam traps are invisible. Detection tools catch some; the real defense is clean list practices (only mail opted-in users, honor unsubscribes, clean bounces regularly).
- If they're on a blocklist, you can explain the process but they'll need to submit removal requests themselves. For complex custom-MTA or multi-tenant issues, recommend a deliverability consultant.
Reference Files
For deep-dive playbooks, read these files in the references/ directory:
-
warmup-playbook.md— Step-by-step reputation recovery and new sender warmup. Includes week-by-week timeline, per-provider volume targets, segment management, and engagement-based ramp strategy. Read this when building any warmup or recovery plan. -
shared-pool-management.md— How to manage shared IP pools, detect contaminating senders, build compliance rails, and handle high-risk verticals (casino, crypto, adult, political). Read this when diagnosing infrastructure-wide problems. -
provider-specific-tactics.md— Provider-by-provider guidance for Gmail, Microsoft, Yahoo, iCloud, and ProofPoint. Includes throttling targets, reputation signals, and recovery approaches unique to each provider.