Agent skill

Email Deliverability

by rampstackco in rampstackco/claude-skills

Make sure email actually reaches inboxes. An agent skill from rampstackco/claude-skills.

MITAuto-check passedBackend & APIs

Install Email Deliverability

skills CLI
$ npx skills add rampstackco/claude-skills --skill email-deliverability -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rampstackco/claude-skills email-deliverability --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/email-deliverability .claude/skills/email-deliverability && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
email-deliverability
GitHub stars
935
Token cost
~2.9k tokens
SKILL.md length
1,448 words
Files
3 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Make sure email actually reaches inboxes. An agent skill from rampstackco/claude-skills.

  • Works in 8 steps: Audit current state → Fix authentication → Set up monitoring → …
  • Setting up email authentication (SPF
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 3 pillars, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Email Deliverability is an agent skill from rampstackco/claude-skills. 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.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/dmarc-rollout-playbook.md`).

It sits in Backend & APIs, covering Transactional email. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • Setting up email authentication (SPF
  • Diagnosing emails landing in spam
  • Planning a domain reputation strategy
  • Monitoring sender reputation

Example prompts

  • “/email-deliverability”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Audit current state
  2. Fix authentication
  3. Set up monitoring
  4. Address list hygiene
  5. Content and pattern audit
  6. Plan for growth
  7. Set up BIMI (optional but valuable)
  8. Document and revisit

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Email Deliverability loads about 2.9k tokens when it runs, and up to ~5.2k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 1,448 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~129
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 1,448 words, ~2,872 tokens.

Download SKILL.mdSave it as .claude/skills/email-deliverability/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
email-deliverability
description
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.
category
operations
catalog_summary
DMARC, SPF, DKIM, sender reputation, deliverability monitoring
display_order
8

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:dmarc-aggregate@example.com; ruf=mailto:dmarc-forensic@example.com; 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:

bash
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.
Show full SKILL.md (589 more words)Show less
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

© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/email-deliverability of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/dmarc-rollout-playbook.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

Email Deliverability next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Email Deliverability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Email Deliverability this skillrampstackco/claude-skills935—~2.9kAutomated safety check: PassMIT
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
WooCommerce Email Editor Developmentwoocommerce/woocommerce11k—~893Automated safety check: PassCustom licence
Email Best Practicesviclafouch/meme-studio1107 repos~787Automated safety check: PassNone
React Emailviclafouch/meme-studio1102 repos~3.6kAutomated safety check: PassMIT
Email Deliverability Auditgrowthenginenowoslawski/coldoutboundskills740—~3.4kAutomated safety check: PassMIT

Similar skills

  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes
  • Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.

    11k GitHub stars~893 tokensUpdated today
    Backend & APIsAuto-check passed
  • Email Best Practices

    viclafouch/meme-studio

    A skill your agent uses when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM…

    110 GitHub starsUsed in 7 repos~787 tokens
    Backend & APIsAuto-check passed
  • React Email

    viclafouch/meme-studio

    A skill your agent uses when creating HTML email templates with React components - welcome emails, password resets, notifications, order confirmations, newsletters, or transactional emails.

    110 GitHub starsUsed in 2 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Email Deliverability Audit

    growthenginenowoslawski/coldoutboundskills

    Diagnostic audit for a running cold email program. An agent skill from growthenginenowoslawski/coldoutboundskills.

    740 GitHub stars~3.4k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing).

    127 GitHub starsUsed in 3 repos~2k tokens
    Backend & APIsAuto-check passed

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    935 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    935 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    935 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    935 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Categories

Questions about Email Deliverability

What does Email Deliverability do?

Make sure email actually reaches inboxes. An agent skill from rampstackco/claude-skills. Email Deliverability is an agent skill from rampstackco/claude-skills. Make sure email actually reaches inboxes.

When should I use Email Deliverability?

Email Deliverability fits situations like: setting up email authentication (SPF; diagnosing emails landing in spam; planning a domain reputation strategy; monitoring sender reputation.

How do I install Email Deliverability in Claude Code?

Run `npx skills add rampstackco/claude-skills --skill email-deliverability -a claude-code`. Or copy the skill folder (skills/email-deliverability in rampstackco/claude-skills) into .claude/skills/email-deliverability in your project. Claude Code loads it when a task matches its description.

How do I install Email Deliverability in Codex?

Run `npx skills add rampstackco/claude-skills --skill email-deliverability -a codex`. Or copy the skill folder (skills/email-deliverability in rampstackco/claude-skills) into .agents/skills/email-deliverability in your project. Codex loads it when a task matches its description.

Can I use Email Deliverability in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill email-deliverability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/email-deliverability, .gemini/skills/email-deliverability, .github/skills/email-deliverability and .opencode/skills/email-deliverability in your project.

What does Email Deliverability need to run?

SKILL.md names no scripts, command-line tools or credentials: Email Deliverability is instructions for the agent only.

Does Email Deliverability access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Email Deliverability safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Email Deliverability use?

Email Deliverability is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Email Deliverability use?

About 2.9k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Email Deliverability?

Skills that share tags, products or a category with Email Deliverability: Stripe Projects (fossasia/eventyay, 1.7k stars), WooCommerce Email Editor Development (woocommerce/woocommerce, 11k stars), Email Best Practices (viclafouch/meme-studio, 110 stars) and React Email (viclafouch/meme-studio, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Email Deliverability?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 935 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.