Email Deliverability Debugger

Diagnoses email deliverability problems for transactional and marketing emails. Checks SPF/DKIM/DMARC alignment, sending IP reputation, email content spam triggers, and bounce patterns. Use when emails land in spam, go missing, or bounce unexpectedly. Trigger words: email spam, deliverability, emails not arriving, bounce rate, spam folder, email reputation, SPF fail, DKIM fail, DMARC, transactional email, SendGrid, Postmark, SES.

213 stars 34 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add TerminalSkills/skills --skill email-deliverability-debugger
Manual install
git clone --depth 1 https://github.com/TerminalSkills/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/email-deliverability-debugger ~/.claude/skills/email-deliverability-debugger

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Email Deliverability Debugger

## Overview

This skill systematically diagnoses why emails fail to reach inboxes by checking the entire delivery chain: DNS authentication (SPF, DKIM, DMARC), sending IP reputation, email content, headers, and provider-specific configuration. It produces actionable fixes ranked by impact.

## Instructions

### Step 1: Check DNS Authentication Records

```bash
# SPF record
dig +short TXT myapp.com | grep "v=spf1"

# DKIM (check common selectors)
for sel in s1 s2 k1 google default sendgrid; do
  dig +short TXT ${sel}._domainkey.myapp.com
done

# DMARC
dig +short TXT _dmarc.myapp.com
```

Validate each:
- **SPF**: Must include all sending services, ≤10 DNS lookups, end with `-all` (hardfail) or `~all` (softfail, common while DMARC does the enforcing)
- **DKIM**: Each sending service needs its own selector with a valid key (2048-bit recommended; 1024 is the minimum Gmail accepts)
- **DMARC**: Should have `p=quarantine` or `p=reject`; `p=none` only monitors (it meets the bulk-sender minimum at Gmail, Yahoo and Outlook, but gives no protection)

### Step 2: Count SPF Lookups

SPF has a hard limit of 10 DNS lookups (RFC 7208). Count each `include:`, `a`, `mx`, `ptr`, `exists:` and `redirect=` as 1 lookup; `ip4:`, `ip6:` and `all` cost nothing. Nested includes count too, and more than 2 void lookups (queries returning nothing) also give a permerror.
Read the full skill on GitHub

Details

Skill name
email-deliverability-debugger
Path
skills/email-deliverability-debugger/SKILL.md
License
Apache-2.0
Repo updated
8 November 2026

FAQ

What does the Email Deliverability Debugger skill do?

Diagnoses email deliverability problems for transactional and marketing emails. Checks SPF/DKIM/DMARC alignment, sending IP reputation, email content spam triggers, and bounce patterns. Use when emails land in spam, go missing, or bounce unexpectedly. Trigger words: email spam, deliverability, emails not arriving, bounce rate, spam folder, email reputation, SPF fail, DKIM fail, DMARC, transactional email, SendGrid, Postmark, SES.

How do I install the Email Deliverability Debugger skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add TerminalSkills/skills --skill email-deliverability-debugger. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Email Deliverability Debugger popular?

It lives in TerminalSkills/skills, which has 213 GitHub stars and 34 forks.

Related skills

3dsmax Rendering

213

TerminalSkills/skills

Scripts and configures production rendering in Autodesk 3ds Max with the V-Ray and Corona renderers: output size and files, render elements, denoising, light mix, batch and command-line rendering, and network rendering. Use when a user asks to set up a production render, render several cameras in one batch, render from the command line or on a render farm, add render passes for compositing, or cut render time for archviz and product shots.

Other34

3dsmax Scripting

213

TerminalSkills/skills

Covers scripting Autodesk 3ds Max, the 3D modeling and rendering application, with MAXScript and Python (pymxs): scene manipulation, object creation, material assignment, camera and light setup, batch operations, and file I/O. Use when tasks involve automating repetitive 3ds Max workflows, batch processing scenes, running scripts headless with 3dsmaxbatch, creating custom tools, or scripting scene setup for archviz, product visualization, or VFX.

Productivity & Notes34

3proxy

213

TerminalSkills/skills

3proxy is a small open-source proxy server that runs HTTP/HTTPS, SOCKS4/5, SNI and TCP/UDP port-mapping proxies from one config file. Use when a user asks to set up an HTTP or SOCKS5 proxy, add proxy users and passwords, write 3proxy access rules, chain or rotate upstream (parent) proxies, limit bandwidth, connections or monthly traffic per user, run 3proxy in Docker, or fix a 3proxy.cfg that will not start.

DevOps & Cloud34

Email Drafter

213

TerminalSkills/skills

Draft professional emails for various business scenarios with appropriate tone and structure. Use when a user asks to write an email, compose a message, draft a reply, write a follow-up, create an outreach email, respond to a client, write a cold email, or craft any professional correspondence.

Productivity & Notes34

Ecc

213

TerminalSkills/skills

ECC (Everything Claude Code) is an open-source toolkit that adds agents, skills, slash commands, rules, hooks and a shared memory vault to coding agents such as Claude Code and Codex. Use it when a user asks to "install ECC", "set up ecc-universal", "add a planning, TDD and code-review workflow to Claude Code", "share memory between Claude and Codex", "scan my agent config with AgentShield", or to "uninstall or repair ECC".

Productivity & Notes34

Email Sequence

213

TerminalSkills/skills

Designs automated email sequences end to end: the trigger, branches and exit rules, the full copy of every message, and the sender setup that keeps them out of spam (SPF, DKIM, DMARC, one-click unsubscribe, consent). Covers onboarding and welcome series, lead nurture, abandoned cart, dunning, win-back and sunset flows. Use when someone asks for a "drip campaign", "welcome sequence", "onboarding emails", "nurture sequence", "win-back emails", "lifecycle emails", "email automation", or says "our emails land in spam" or "nobody clicks our onboarding emails". In-app onboarding belongs to onboardin

Productivity & Notes34

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.