email-diagnostics

Diagnose email deliverability issues with structured decision trees and workflows.

2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/chunkydotdev/email-skills --skill email-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email-diagnostics
Source: https://github.com/chunkydotdev/email-skills/tree/main/skills/diagnostics/email-diagnostics
Command: npx skills add https://github.com/chunkydotdev/email-skills --skill email-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork when you encounter email problems or are building new email infrastructure, ensuring you address root causes instead of wasting time on irrelevant symptoms.

Core Features & Use Cases

  • Intelligent Skill Routing: Directs you to the exact specialized skills needed for your specific problem (spam, bounces, blocklists, throttling, compliance, etc.) so you don't have to search for guidance manually.
  • Ordered Diagnostic Workflows: Provides cost-effective, step-by-step checklists for common email issues, starting with the most common and easiest-to-fix problems first to speed up resolution.
  • End-to-End Setup Guidance: Includes complete sequences for greenfield email setup, provider migrations, volume scaling, and AI agent inbox configuration.
  • Use Case: If your marketing emails are suddenly landing in spam, this skill walks you through authentication, reputation, content, and engagement checks in order, then tells you exactly which specialized skills to load to resolve each identified issue.

Quick Start

Use the email-diagnostics skill to diagnose why your emails are landing in spam and get the exact steps and specialized skills needed to fix the root cause.

Frequently Asked Questions about email-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my marketing emails suddenly landing in the spam folder?

Email spam placement is typically caused by authentication gaps, sender reputation drops, or content triggers. This skill diagnoses spam issues by running structured checks across authentication, reputation, content, and engagement metrics to pinpoint the exact root cause.

How do I troubleshoot a sudden spike in email bounce rates?

Bounce rate spikes require immediate diagnosis to prevent further reputation damage. This skill runs ordered diagnostic workflows to identify whether the root cause is blocklist listings, invalid recipient data, or provider throttling, then routes you to specialized resolution steps.

What is the best way to diagnose email blocklist listings and throttling issues?

Diagnosing blocklist listings and throttling involves checking your sending infrastructure against known blacklists and provider rate limits. This skill provides step-by-step diagnostic workflows to identify the listing source and routes you to specialized skills for blocklist removal.

Can I use this for greenfield email setup and provider migrations?

Yes, this skill includes complete diagnostic sequences for greenfield email setup, provider migrations, and volume scaling. It ensures your new email infrastructure is configured correctly to avoid early deliverability problems and compliance requests.

How do I configure email infrastructure for AI agents to avoid spam filters?

AI agent email configuration requires proper authentication and reputation management to avoid spam filters. This skill provides end-to-end setup guidance and diagnostic workflows to ensure automated emails are correctly authenticated and compliant.

What should I do if my email deliverability drops after scaling sending volume?

Deliverability drops after volume scaling often stem from throttling or reputation issues. This skill provides structured decision trees to diagnose whether the problem is volume-related throttling, authentication stress, or engagement degradation, then routes to the correct fix.