EM

email-deliverability

It improves email deliverability by monitoring metrics, suggesting warm-up schedules, and identifying content that triggers spam filters.

Install

mkdir -p .claude/skills/email-deliverability && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7046" && unzip -o skill.zip -d .claude/skills/email-deliverability && rm skill.zip

Installs to .claude/skills/email-deliverability

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Email deliverability best practices and troubleshooting
55 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Analyze email deliverability metrics
  • Schedule IP/domain warm-up progression
  • Identify content-based spam triggers
  • Audit DNS records for SPF/DKIM/DMARC

How it works

Evaluates email practices against a checklist of reputation signals and technical requirements.

Inputs & outputs

You give it
Domain or email template
You get back
Deliverability health assessment or warm-up plan

When to use email-deliverability

  • Diagnosing high email bounce rates
  • Planning a new IP/domain warm-up schedule
  • Refining email templates to avoid spam filters
  • Analyzing sender reputation signals

About this skill

plugin: instantly updated: 2026-01-20

Email Deliverability

Deliverability Fundamentals

Key Metrics

MetricHealthyWarningCritical
Bounce Rate<2%2-5%>5%
Spam Complaint Rate<0.1%0.1-0.5%>0.5%
Inbox Placement>95%80-95%<80%
Sender Score>8060-80<60

Deliverability Components

DELIVERABILITY =
  Sender Reputation (40%)
  + Content Quality (30%)
  + Technical Setup (20%)
  + List Quality (10%)

Sender Reputation

Warm-Up Schedule

DayEmails/DayTotal Sent
1-710-2070-140
8-1430-50280-490
15-2175-100805-1190
22-28150-2001855-2590
29+Scale gradually-

Reputation Signals

Positive SignalsNegative Signals
OpensSpam complaints
RepliesHard bounces
ClicksLow engagement
ForwardsUnsubscribes
Non-spam markingSpam trap hits

Content Quality

Spam Filter Triggers

High-Risk Words:

FREE, GUARANTEE, WINNER, CASH, PRIZE
URGENT, ACT NOW, LIMITED TIME
Click here, Click below, Don't miss
Make money, Extra income, Work from home

Formatting Red Flags:

  • ALL CAPS in subject or body
  • Multiple exclamation marks!!!
  • Colored fonts
  • Excessive links (>1)
  • Images (especially in cold email)
  • Attachments

Safe Practices

DoDon't
Plain text emailsHTML-heavy templates
Single link (if any)Multiple CTAs
Conversational toneSalesy language
Short sentencesLong paragraphs
Proper grammarTypos and errors

Technical Setup

Required DNS Records

RecordPurposeStatus Check
SPFAuthorize sending serversnslookup -type=TXT domain
DKIMEmail signature verificationCheck in email headers
DMARCPolicy for failed checksnslookup -type=TXT _dmarc.domain

Recommended Settings

SPF: v=spf1 include:_spf.instantly.ai ~all
DKIM: Configure via Instantly dashboard
DMARC: v=DMARC1; p=none; rua=mailto:[email protected]

List Quality

Email Verification

Verification LevelDescriptionBounce Rate
Syntax checkValid formatReduces 5-10%
Domain checkValid domainReduces 10-20%
Mailbox checkExistsReduces 20-40%
Engagement checkActiveReduces 5-15%

List Hygiene

PracticeFrequencyImpact
Remove hard bouncesImmediatelyCritical
Remove soft bouncesAfter 3 attemptsHigh
Remove unsubscribesImmediatelyCritical
Re-verify listEvery 3 monthsMedium

Troubleshooting

High Bounce Rate (>5%)

Diagnosis Steps:

  1. Check bounce types (hard vs soft)
  2. Identify source (specific list segment?)
  3. Verify emails before adding to campaign

Remediation:

  1. Pause campaign immediately
  2. Remove all hard bounces
  3. Re-verify remaining list
  4. Resume with verified emails only

Low Open Rate (<15%)

Possible Causes:

  1. Poor sender reputation
  2. Landing in spam/promotions
  3. Bad subject lines
  4. Wrong send time

Diagnosis:

  1. Check sender score
  2. Send test emails to Gmail/Outlook
  3. Review recent changes to sending

Spam Complaints (>0.1%)

Immediate Actions:

  1. Pause campaign
  2. Review targeting (wrong ICP?)
  3. Check email frequency
  4. Review unsubscribe visibility

Long-term:

  1. Improve list sourcing
  2. Better qualification
  3. Add clear opt-out

Recovery Playbook

Reputation Recovery

DayActionExpected Outcome
1-3Pause all sendingStop damage
4-7Remove problem addressesClean list
8-14Warm up from scratchRebuild slowly
15-21Monitor metrics closelyCatch issues early
22+Gradually scaleSustainable growth

Blacklist Removal

  1. Identify which blacklists (MXToolbox)
  2. Fix underlying issue first
  3. Request removal from each list
  4. Wait 24-72 hours
  5. Re-check and repeat if needed

When not to use it

  • Internal-only email services
  • Transactional emails not subject to marketing filters

Limitations

  • Deliverability is heavily influenced by external spam filters
  • Warm-up plans are recommendations, not guarantees

How it compares

It offers reputation-focused engineering advice rather than just SMTP configuration steps.

Compared to similar skills

email-deliverability side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
email-deliverability (this skill)16moNo flagsIntermediate
email-systems56moNo flagsAdvanced
voice-update16moReviewBeginner
send-payload04moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

More by MadAppGang

View all by MadAppGang

claudish-usage

MadAppGang

CRITICAL - Guide for using Claudish CLI ONLY through sub-agents to run Claude Code with any AI model (OpenRouter, Gemini, OpenAI, local models). NEVER run Claudish directly in main context unless user explicitly requests it. Use when user mentions external AI models, Claudish, OpenRouter, Gemini, OpenAI, Ollama, or alternative models. Includes mandatory sub-agent delegation patterns, agent selection guide, file-based instructions, and strict rules to prevent context window pollution.

442

golang-performance

MadAppGang

Use when profiling Go applications (pprof), running benchmarks, optimizing memory/CPU usage, or debugging performance bottlenecks in production Go code.

47

golang

MadAppGang

Use when building Go backend services, implementing goroutines/channels, handling errors idiomatically, writing tests with testify, or following Go best practices for APIs/CLI tools.

313

schemas

MadAppGang

YAML frontmatter schemas for Claude Code agents and commands. Use when creating or validating agent/command files.

34

external-model-selection

MadAppGang

Choose optimal external AI models for code analysis, bug investigation, and architectural decisions. Use when consulting multiple LLMs via claudish, comparing model perspectives, or investigating complex Go/LSP/transpiler issues. Provides empirically validated model rankings (91/100 for MiniMax M2, 83/100 for Grok Code Fast) and proven consultation strategies based on real-world testing.

218

adr-documentation

MadAppGang

Architecture Decision Records (ADR) documentation practice. Use when documenting architectural decisions, recording technical trade-offs, creating decision logs, or establishing architectural patterns. Trigger keywords - "ADR", "architecture decision", "decision record", "trade-offs", "architectural decision", "decision log".

12

You might also like

email-systems

davila7

Email has the highest ROI of any marketing channel. $36 for every $1 spent. Yet most startups treat it as an afterthought - bulk blasts, no personalization, landing in spam folders. This skill covers transactional email that works, marketing automation that converts, deliverability that reaches inboxes, and the infrastructure decisions that scale. Use when: keywords, file_patterns, code_patterns.

548

voice-update

pchalasani

This skill should be used when the agent needs to give a spoken voice update to the user, or when reminded by a Stop hook to provide audio feedback. Use this skill to speak a short summary of what was accomplished.

11

send-payload

ArgentAIOS

Use the core `send_payload` tool to deliver one message to many routes in a single call.

00

home-assistant-manager

komal-SkyNET

Expert-level Home Assistant configuration management with efficient deployment workflows (git and rapid scp iteration), remote CLI access via SSH and hass-cli, automation verification protocols, log analysis, reload vs restart optimization, and comprehensive Lovelace dashboard management for tablet-optimized UIs. Includes template patterns, card types, debugging strategies, and real-world examples.

9110

firecrawl-incident-runbook

jeremylongshore

Execute FireCrawl incident response procedures with triage, mitigation, and postmortem. Use when responding to FireCrawl-related outages, investigating errors, or running post-incident reviews for FireCrawl integration failures. Trigger with phrases like "firecrawl incident", "firecrawl outage", "firecrawl down", "firecrawl on-call", "firecrawl emergency", "firecrawl broken".

18

netalertx-plugin-run-development

netalertx

Create and run NetAlertX plugins. Use this when asked to create plugin, run plugin, test plugin, plugin development, or execute plugin script.

14

Search skills

Search the agent skills registry