Email deliverability

Make sure email actually reaches inboxes.

Email deliverability — Creative Direction skill highlight diagram. Navy header card reads 'Impactful Creative Direction' with the subtitle… (from the rampstackco/claude-skills README)

From the rampstackco/claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/email-deliverability-2.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit rampstackco/claude-skills/skills/email-deliverability#main ~/.claude/skills/email-deliverability-2

For one project only, change the path to .claude/skills/email-deliverability-2.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Email deliverability

Show the full text284 lines
namedescriptioncategorycatalog_summarydisplay_order
email-deliverabilityMake sure email actually reaches inboxes. Use this skill when setting up email authentication (SPF, DKIM, DMARC), diagnosing emails landing in spam, planning a domain reputation strategy, monitoring sender reputation, or hardening against email spoofing. Triggers on email deliverability, SPF, DKIM, DMARC, spam folder, sender reputation, mailbox provider, soft bounces, bounce rate, BIMI, MTA-STS, deliverability audit. Also triggers when a marketing or transactional email isn't reaching users.operationsDMARC, SPF, DKIM, sender reputation, deliverability monitoring8

Email Deliverability

Get email into inboxes, not spam folders. Set up authentication. Monitor reputation. Diagnose problems before they hurt the business.


When to use

  • Setting up email for a new domain
  • A meaningful percentage of email is going to spam
  • Customers report they're not receiving emails
  • Setting up DMARC, SPF, or DKIM
  • Hardening against domain spoofing
  • Migrating email service providers
  • Sender reputation has dropped
  • Pre-launch audit before sending volume increases

When NOT to use

  • Writing the email content itself (use email-sequences)
  • Designing the email program strategy (use email-sequences)
  • DNS records in general (use domain-strategy)
  • Outbound spam coming FROM your account (different problem; investigate compromised credentials)

Required inputs

  • The sending domain(s)
  • The email service provider (ESP, transactional service, mail server)
  • Current DNS records (or access to them)
  • Email volume (transactional vs marketing, daily volume)
  • Current deliverability state (if known: bounce rate, spam complaints)

The framework: 3 pillars

Email deliverability rests on three pillars. Weakness in any one limits the others.

Pillar 1: Authentication

Mailbox providers verify email is actually from who it claims to be from. Three records.

SPF (Sender Policy Framework)

Lists which servers are authorized to send mail for the domain. Published as a TXT record at the apex.

v=spf1 include:_spf.mailprovider.com -all
  • include: adds another sender's authorized list
  • -all (hard fail): mail from unlisted senders fails authentication
  • ~all (soft fail): unlisted senders are suspicious but pass; useful during rollout
  • +all: never use; allows anyone to send

Only one SPF record per domain. Multiple SPF records break SPF entirely. Combine senders into a single record.

SPF has a 10-DNS-lookup limit. Each include: may use multiple lookups. Hit the limit and SPF stops working. Watch this carefully.

DKIM (DomainKeys Identified Mail)

A cryptographic signature on each outgoing email. The mail server signs with a private key; the public key is published in DNS.

selector1._domainkey.example.com    TXT    "v=DKIM1; k=rsa; p=MIGfMA0G..."

Selectors differ by ESP. Some use default._domainkey, some use unique selectors per service. Most ESPs walk you through publishing the records.

DKIM proves the message wasn't modified in transit and that the sender controls the domain.

DMARC (Domain-based Message Authentication, Reporting, and Conformance)

The policy layer. Tells receivers what to do when SPF or DKIM fails, and where to send reports.

_dmarc.example.com    TXT    "v=DMARC1; p=reject; rua=mailto:[email protected]; ruf=mailto:[email protected]; pct=100; adkim=s; aspf=s"

Components:

  • p=: policy. none, quarantine, or reject.
  • rua=: aggregate reports (daily, summary). Always set this.
  • ruf=: forensic reports (per-message). Optional, can be high volume.
  • pct=: percentage of failing mail subject to the policy. Useful for gradual rollout.
  • adkim=, aspf=: alignment mode. s (strict), r (relaxed). Strict means From: domain must match exactly.

DMARC is the most important record. It's what makes spoofing your domain hard.

Pillar 2: Reputation

Mailbox providers (Gmail, Outlook, Yahoo) score every sender. Reputation drives delivery.

Reputation factors:

  • Authentication pass rates (SPF, DKIM, DMARC)
  • Engagement signals (opens, replies, marking as not-spam)
  • Negative signals (spam complaints, deletions without opens, blocking)
  • List hygiene (low bounce rates, no spam traps)
  • Volume consistency (sudden spikes look like spam)
  • Content patterns (link reputation, attachment patterns)
  • IP and domain history

Reputation is per (sending domain × mailbox provider). Gmail's view of you is independent of Outlook's.

Pillar 3: List quality and engagement

Authentication and reputation rest on list quality. Bad list = bad reputation eventually.

  • Only send to people who explicitly opted in
  • Confirmed (double) opt-in for marketing wherever feasible
  • Honor unsubscribes immediately and reliably
  • Remove hard bounces immediately
  • Sunset disengaged contacts (no opens in 6 months: reduce frequency or remove)
  • Avoid third-party lists, scraped emails, or "purchased opt-ins"

The single biggest deliverability lever for most senders is list hygiene.


Workflow

Step 1: Audit current state

Check the current DNS records:

dig +short txt example.com
dig +short txt selector1._domainkey.example.com
dig +short txt _dmarc.example.com

Also check:

  • Current bounce rate (target: under 2%)
  • Current spam complaint rate (target: under 0.1%)
  • Current open rate (varies by industry; falling trend is a warning)
  • Current sending volume

Tools: mxtoolbox.com, dmarcian.com, mail-tester.com (for individual messages).

Step 2: Fix authentication

If any of SPF, DKIM, DMARC is missing or misconfigured, fix first.

SPF fix order:

  1. Identify all legitimate senders (transactional ESP, marketing ESP, support tools, etc.)
  2. Get the include: value or IP for each
  3. Combine into a single SPF record
  4. Verify lookup count is under 10
  5. Use -all for hard fail (or ~all if rolling out gradually)

DKIM fix order:

  1. Generate a new selector per sending service
  2. Publish the public key in DNS
  3. Configure the ESP to sign with the private key
  4. Verify with a test send (check headers for dkim=pass)

DMARC fix order:

  1. Publish DMARC with p=none initially (monitoring mode)
  2. Set up an aggregate report endpoint (use a DMARC analytics service or your own)
  3. Watch reports for at least 2-4 weeks
  4. Identify any legitimate senders failing alignment; fix them
  5. Move to p=quarantine with pct=10, gradually increase
  6. Move to p=reject once confidence is high

The full progression typically takes 2-3 months. Rushing causes legitimate mail to bounce.

Step 3: Set up monitoring

Ongoing visibility:

  • DMARC aggregate reports: parsed daily. Watch for new sources, alignment failures, volume changes.
  • Bounce rate: per ESP dashboard. Target under 2% for transactional, under 5% for marketing.
  • Spam complaint rate: target under 0.1%.
  • Reputation tools: Google Postmaster Tools (free), Microsoft SNDS, Talos, Sender Score.
  • Blacklist monitoring: most ESPs include this; otherwise mxtoolbox.com or hetrixtools.com.
Step 4: Address list hygiene
  • Remove hard bounces from your sending lists immediately (most ESPs do this; verify)
  • Set up suppression lists (unsubscribes, manual blocks, deliverability sinkholes)
  • Sunset disengaged contacts (re-engagement campaigns or just remove)
  • Review opt-in flows: do people know what they're signing up for?
Step 5: Content and pattern audit

If reputation is good and authentication passes, check content:

  • HTML-only emails (no plain-text alternative) raise flags
  • Heavy image-to-text ratios raise flags
  • Suspicious link patterns (bare IPs, URL shorteners, hijacked domains)
  • Specific spam-trigger words in subject lines (less important than it used to be, still real)
  • Lots of mismatched domains in URLs
  • Generic from-name like "info@" rather than a real-sounding sender
Step 6: Plan for growth

Email volume affects reputation. Sudden spikes look like spam.

  • Warm up new sending IPs gradually (start at 50/day, 2x daily)
  • Warm up new domains gradually (similar pattern)
  • Spread sends throughout the day
  • Don't switch ESPs the week before a big launch
Step 7: Set up BIMI (optional but valuable)

BIMI (Brand Indicators for Message Identification) shows your logo next to authenticated emails in supporting clients (Gmail, Apple Mail, Yahoo, others).

Requires:

  • DMARC at p=quarantine or p=reject (so this comes after the DMARC progression)
  • A trademarked logo as an SVG (specific format requirements)
  • A Verified Mark Certificate (VMC) from a CA, for Gmail and others
  • A _bimi DNS record pointing to the SVG and VMC

BIMI improves trust signals and engagement. Worth doing once DMARC enforcement is in place.

Step 8: Document and revisit

Document the email architecture:

  • Sending domains and subdomains
  • Each ESP and what it sends
  • DNS records for each
  • Monitoring setup
  • Escalation if deliverability degrades

Revisit quarterly or when a new ESP is added.


Failure patterns

Multiple SPF records. Two or more SPF records on the same domain breaks SPF. Combine into one.

SPF DNS lookup limit exceeded. Too many include: directives or chained includes. Flatten or simplify.

DMARC at p=none forever. Monitoring without enforcement. Spoofing remains easy. Move to enforcement.

DMARC at p=reject too quickly. Legitimate mail bounces because alignment wasn't verified. Use the gradual rollout.

Sending from a different domain than the From: address. Causes alignment failures. Fix the From: domain or ensure proper alignment.

Using a shared ESP IP without ESP-specific configuration. Some ESPs don't sign with your DKIM by default; the signature is the ESP's, not yours. Configure custom DKIM.

Sending from a domain that also sends marketing. A spam complaint on a marketing email hurts transactional deliverability. Use a subdomain for transactional (transactional.example.com) or marketing (mail.example.com).

No bounce monitoring. Hard bounces accumulate, reputation tanks, deliverability cliff-falls. Monitor.

Bought lists or scraped contacts. Spam traps in those lists destroy reputation. Don't.

No double opt-in for marketing. Single opt-in lets bots and typos onto the list. Bots generate spam complaints, destroy reputation.

Ignoring DMARC reports. Reports show problems early. Set up a parser. Look weekly.

Treating "marked as not-spam" as the goal. The goal is to never land in spam in the first place. Once reputation is bad, recovery takes months.


Output format

A deliverability audit document includes:

  • Domain inventory: every sending domain
  • Authentication status: SPF, DKIM, DMARC per domain
  • Sender inventory: every ESP or service that sends mail, what's configured
  • Reputation status: per major mailbox provider where measurable
  • List hygiene: bounce rate, complaint rate, opt-in process
  • Findings: prioritized issues
  • Roadmap: SPF/DKIM/DMARC fixes, BIMI plan, monitoring plan
  • Monitoring setup: what's watched, where alerts go

Reference files

1---
2name: email-deliverability
3description: "Make sure email actually reaches inboxes. Use this skill when setting up email authentication (SPF, DKIM, DMARC), diagnosing emails landing in spam, planning a domain reputation strategy, monitoring sender reputation, or hardening against email spoofing. Triggers on email deliverability, SPF, DKIM, DMARC, spam folder, sender reputation, mailbox provider, soft bounces, bounce rate, BIMI, MTA-STS, deliverability audit. Also triggers when a marketing or transactional email isn't reaching users."
4category: operations
5catalog_summary: "DMARC, SPF, DKIM, sender reputation, deliverability monitoring"
6display_order: 8
7---
8 
9# Email Deliverability
10 
11Get email into inboxes, not spam folders. Set up authentication. Monitor reputation. Diagnose problems before they hurt the business.
12 
13---
14 
15## When to use
16 
17- Setting up email for a new domain
18- A meaningful percentage of email is going to spam
19- Customers report they're not receiving emails
20- Setting up DMARC, SPF, or DKIM
21- Hardening against domain spoofing
22- Migrating email service providers
23- Sender reputation has dropped
24- Pre-launch audit before sending volume increases
25 
26## When NOT to use
27 
28- Writing the email content itself (use `email-sequences`)
29- Designing the email program strategy (use `email-sequences`)
30- DNS records in general (use `domain-strategy`)
31- Outbound spam coming FROM your account (different problem; investigate compromised credentials)
32 
33---
34 
35## Required inputs
36 
37- The sending domain(s)
38- The email service provider (ESP, transactional service, mail server)
39- Current DNS records (or access to them)
40- Email volume (transactional vs marketing, daily volume)
41- Current deliverability state (if known: bounce rate, spam complaints)
42 
43---
44 
45## The framework: 3 pillars
46 
47Email deliverability rests on three pillars. Weakness in any one limits the others.
48 
49### Pillar 1: Authentication
50 
51Mailbox providers verify email is actually from who it claims to be from. Three records.
52 
53**SPF (Sender Policy Framework)**
54 
55Lists which servers are authorized to send mail for the domain. Published as a TXT record at the apex.
56 
57```
58v=spf1 include:_spf.mailprovider.com -all
59```
60 
61- `include:` adds another sender's authorized list
62- `-all` (hard fail): mail from unlisted senders fails authentication
63- `~all` (soft fail): unlisted senders are suspicious but pass; useful during rollout
64- `+all`: never use; allows anyone to send
65 
66Only one SPF record per domain. Multiple SPF records break SPF entirely. Combine senders into a single record.
67 
68SPF has a 10-DNS-lookup limit. Each `include:` may use multiple lookups. Hit the limit and SPF stops working. Watch this carefully.
69 
70**DKIM (DomainKeys Identified Mail)**
71 
72A cryptographic signature on each outgoing email. The mail server signs with a private key; the public key is published in DNS.
73 
74```
75selector1._domainkey.example.com TXT "v=DKIM1; k=rsa; p=MIGfMA0G..."
76```
77 
78Selectors differ by ESP. Some use `default._domainkey`, some use unique selectors per service. Most ESPs walk you through publishing the records.
79 
80DKIM proves the message wasn't modified in transit and that the sender controls the domain.
81 
82**DMARC (Domain-based Message Authentication, Reporting, and Conformance)**
83 
84The policy layer. Tells receivers what to do when SPF or DKIM fails, and where to send reports.
85 
86```
87_dmarc.example.com TXT "v=DMARC1; p=reject; rua=mailto:[email protected]; ruf=mailto:[email protected]; pct=100; adkim=s; aspf=s"
88```
89 
90Components:
91- `p=`: policy. `none`, `quarantine`, or `reject`.
92- `rua=`: aggregate reports (daily, summary). Always set this.
93- `ruf=`: forensic reports (per-message). Optional, can be high volume.
94- `pct=`: percentage of failing mail subject to the policy. Useful for gradual rollout.
95- `adkim=`, `aspf=`: alignment mode. `s` (strict), `r` (relaxed). Strict means From: domain must match exactly.
96 
97DMARC is the most important record. It's what makes spoofing your domain hard.
98 
99### Pillar 2: Reputation
100 
101Mailbox providers (Gmail, Outlook, Yahoo) score every sender. Reputation drives delivery.
102 
103Reputation factors:
104- **Authentication pass rates** (SPF, DKIM, DMARC)
105- **Engagement signals** (opens, replies, marking as not-spam)
106- **Negative signals** (spam complaints, deletions without opens, blocking)
107- **List hygiene** (low bounce rates, no spam traps)
108- **Volume consistency** (sudden spikes look like spam)
109- **Content patterns** (link reputation, attachment patterns)
110- **IP and domain history**
111 
112Reputation is per (sending domain × mailbox provider). Gmail's view of you is independent of Outlook's.
113 
114### Pillar 3: List quality and engagement
115 
116Authentication and reputation rest on list quality. Bad list = bad reputation eventually.
117 
118- Only send to people who explicitly opted in
119- Confirmed (double) opt-in for marketing wherever feasible
120- Honor unsubscribes immediately and reliably
121- Remove hard bounces immediately
122- Sunset disengaged contacts (no opens in 6 months: reduce frequency or remove)
123- Avoid third-party lists, scraped emails, or "purchased opt-ins"
124 
125The single biggest deliverability lever for most senders is list hygiene.
126 
127---
128 
129## Workflow
130 
131### Step 1: Audit current state
132 
133Check the current DNS records:
134 
135```bash
136dig +short txt example.com
137dig +short txt selector1._domainkey.example.com
138dig +short txt _dmarc.example.com
139```
140 
141Also check:
142- Current bounce rate (target: under 2%)
143- Current spam complaint rate (target: under 0.1%)
144- Current open rate (varies by industry; falling trend is a warning)
145- Current sending volume
146 
147Tools: mxtoolbox.com, dmarcian.com, mail-tester.com (for individual messages).
148 
149### Step 2: Fix authentication
150 
151If any of SPF, DKIM, DMARC is missing or misconfigured, fix first.
152 
153**SPF fix order:**
1541. Identify all legitimate senders (transactional ESP, marketing ESP, support tools, etc.)
1552. Get the `include:` value or IP for each
1563. Combine into a single SPF record
1574. Verify lookup count is under 10
1585. Use `-all` for hard fail (or `~all` if rolling out gradually)
159 
160**DKIM fix order:**
1611. Generate a new selector per sending service
1622. Publish the public key in DNS
1633. Configure the ESP to sign with the private key
1644. Verify with a test send (check headers for `dkim=pass`)
165 
166**DMARC fix order:**
1671. Publish DMARC with `p=none` initially (monitoring mode)
1682. Set up an aggregate report endpoint (use a DMARC analytics service or your own)
1693. Watch reports for at least 2-4 weeks
1704. Identify any legitimate senders failing alignment; fix them
1715. Move to `p=quarantine` with `pct=10`, gradually increase
1726. Move to `p=reject` once confidence is high
173 
174The full progression typically takes 2-3 months. Rushing causes legitimate mail to bounce.
175 
176### Step 3: Set up monitoring
177 
178Ongoing visibility:
179 
180- **DMARC aggregate reports**: parsed daily. Watch for new sources, alignment failures, volume changes.
181- **Bounce rate**: per ESP dashboard. Target under 2% for transactional, under 5% for marketing.
182- **Spam complaint rate**: target under 0.1%.
183- **Reputation tools**: Google Postmaster Tools (free), Microsoft SNDS, Talos, Sender Score.
184- **Blacklist monitoring**: most ESPs include this; otherwise mxtoolbox.com or hetrixtools.com.
185 
186### Step 4: Address list hygiene
187 
188- Remove hard bounces from your sending lists immediately (most ESPs do this; verify)
189- Set up suppression lists (unsubscribes, manual blocks, deliverability sinkholes)
190- Sunset disengaged contacts (re-engagement campaigns or just remove)
191- Review opt-in flows: do people know what they're signing up for?
192 
193### Step 5: Content and pattern audit
194 
195If reputation is good and authentication passes, check content:
196 
197- HTML-only emails (no plain-text alternative) raise flags
198- Heavy image-to-text ratios raise flags
199- Suspicious link patterns (bare IPs, URL shorteners, hijacked domains)
200- Specific spam-trigger words in subject lines (less important than it used to be, still real)
201- Lots of mismatched domains in URLs
202- Generic from-name like "info@" rather than a real-sounding sender
203 
204### Step 6: Plan for growth
205 
206Email volume affects reputation. Sudden spikes look like spam.
207 
208- Warm up new sending IPs gradually (start at 50/day, 2x daily)
209- Warm up new domains gradually (similar pattern)
210- Spread sends throughout the day
211- Don't switch ESPs the week before a big launch
212 
213### Step 7: Set up BIMI (optional but valuable)
214 
215BIMI (Brand Indicators for Message Identification) shows your logo next to authenticated emails in supporting clients (Gmail, Apple Mail, Yahoo, others).
216 
217Requires:
218- DMARC at `p=quarantine` or `p=reject` (so this comes after the DMARC progression)
219- A trademarked logo as an SVG (specific format requirements)
220- A Verified Mark Certificate (VMC) from a CA, for Gmail and others
221- A `_bimi` DNS record pointing to the SVG and VMC
222 
223BIMI improves trust signals and engagement. Worth doing once DMARC enforcement is in place.
224 
225### Step 8: Document and revisit
226 
227Document the email architecture:
228- Sending domains and subdomains
229- Each ESP and what it sends
230- DNS records for each
231- Monitoring setup
232- Escalation if deliverability degrades
233 
234Revisit quarterly or when a new ESP is added.
235 
236---
237 
238## Failure patterns
239 
240**Multiple SPF records.** Two or more SPF records on the same domain breaks SPF. Combine into one.
241 
242**SPF DNS lookup limit exceeded.** Too many `include:` directives or chained includes. Flatten or simplify.
243 
244**DMARC at `p=none` forever.** Monitoring without enforcement. Spoofing remains easy. Move to enforcement.
245 
246**DMARC at `p=reject` too quickly.** Legitimate mail bounces because alignment wasn't verified. Use the gradual rollout.
247 
248**Sending from a different domain than the From: address.** Causes alignment failures. Fix the From: domain or ensure proper alignment.
249 
250**Using a shared ESP IP without ESP-specific configuration.** Some ESPs don't sign with your DKIM by default; the signature is the ESP's, not yours. Configure custom DKIM.
251 
252**Sending from a domain that also sends marketing.** A spam complaint on a marketing email hurts transactional deliverability. Use a subdomain for transactional (`transactional.example.com`) or marketing (`mail.example.com`).
253 
254**No bounce monitoring.** Hard bounces accumulate, reputation tanks, deliverability cliff-falls. Monitor.
255 
256**Bought lists or scraped contacts.** Spam traps in those lists destroy reputation. Don't.
257 
258**No double opt-in for marketing.** Single opt-in lets bots and typos onto the list. Bots generate spam complaints, destroy reputation.
259 
260**Ignoring DMARC reports.** Reports show problems early. Set up a parser. Look weekly.
261 
262**Treating "marked as not-spam" as the goal.** The goal is to never land in spam in the first place. Once reputation is bad, recovery takes months.
263 
264---
265 
266## Output format
267 
268A deliverability audit document includes:
269 
270- **Domain inventory:** every sending domain
271- **Authentication status:** SPF, DKIM, DMARC per domain
272- **Sender inventory:** every ESP or service that sends mail, what's configured
273- **Reputation status:** per major mailbox provider where measurable
274- **List hygiene:** bounce rate, complaint rate, opt-in process
275- **Findings:** prioritized issues
276- **Roadmap:** SPF/DKIM/DMARC fixes, BIMI plan, monitoring plan
277- **Monitoring setup:** what's watched, where alerts go
278 
279---
280 
281## Reference files
282 
283- [`references/dmarc-rollout-playbook.md`](references/dmarc-rollout-playbook.md): Step-by-step for moving from no DMARC to `p=reject`, with timing, monitoring, and how to handle problems found along the way.
284 

Discussion

Alternatives

Also in Email sequencesSee all 364 in Marketing →