email-deliverability

1
1
Source

Email deliverability best practices and troubleshooting

Install

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

Installs to .claude/skills/email-deliverability

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

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.

413

schemas

MadAppGang

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

23

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.

102

golang-performance

MadAppGang

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

52

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.

172

hierarchical-coordinator

MadAppGang

Prevent goal drift in long-running multi-agent workflows using a coordinator agent that validates outputs against original objectives at checkpoints. Use when orchestrating 3+ agents, multi-phase features, complex implementations, or any workflow where agents may lose sight of original requirements. Trigger keywords - "hierarchical", "coordinator", "anti-drift", "checkpoint", "validation", "goal-alignment", "decomposition", "phase-gate", "shared-state", "drift detection".

21

You might also like

flutter-development

aj-geddes

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

1,6851,428

ui-ux-pro-max

nextlevelbuilder

"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."

1,2641,326

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

1,5331,147

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

1,355809

nano-banana-pro

garg-aayush

Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.

1,264727

pdf-to-markdown

aliceisjustplaying

Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.

1,483684