twilio-sendgrid-deliverability-advisor

Diagnoses SendGrid email deliverability problems and recommends authentication, list hygiene, and warmup fixes.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-deliverability-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twilio-sendgrid-deliverability-advisor
Source: https://github.com/openai/plugins/tree/main/plugins/twilio-developer-kit/skills/twilio-sendgrid-deliverability-advisor
Command: npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-deliverability-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Emails landing in spam, bouncing, or getting blocked are hard to diagnose because causes range from missing SPF/DKIM/DMARC records to poor sender reputation and un-warmed IPs. This Skill provides a structured diagnostic framework that identifies the root cause of SendGrid deliverability issues and prescribes concrete remediation steps.

Core Features & Use Cases

  • Symptom-Based Diagnosis: Classifies issues as acute (sudden blocks, bounce spikes), gradual (declining engagement), or proactive (new IP/domain setup), then walks through targeted diagnostic questions.
  • Authentication & Foundation Checklist: Covers SPF, DKIM, DMARC, BIMI, link branding, and reverse DNS setup, plus IP warmup guidance including SendGrid's 41-day automated warmup schedule.
  • Provider-Specific Guidance: Reference tables for Gmail, Yahoo, Microsoft, Apple, Comcast, and Orange requirements, plus a blocklist quick reference (Spamhaus, Proofpoint, SpamCop) with delisting procedures.
  • Use Case: A developer notices open rates dropping and emails landing in Gmail spam. The Skill checks domain authentication, reviews bounce and spam complaint thresholds, inspects the SEQ score, and outputs a prioritized action plan.

Quick Start

Ask the assistant to diagnose why your SendGrid emails are going to spam and recommend fixes for your sender reputation.

Frequently Asked Questions about twilio-sendgrid-deliverability-advisor

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

FAQPage Schema
How do I fix SendGrid emails going to spam?

First verify SPF, DKIM, and DMARC are configured in SendGrid Sender Authentication, since missing authentication is the most common root cause. Then check your SEQ score, segment sends to engaged subscribers, and review content for spammy subject lines or poor text-to-image ratios.

What is a good bounce rate for SendGrid email sending?

A healthy hard bounce rate is under 1%, with 1-2% as a warning zone and above 2% critical. Spam complaint rates should stay below 0.08%, and soft bounces below 5%. Hard bounces must be removed immediately after each send.

How does SendGrid IP warmup work for a new dedicated IP?

SendGrid automated warmup runs a 41-day schedule on Pro and Premier plans, capping hourly volume and starting with your most engaged subscribers. Since June 2025, overflow no longer falls back to shared pools; excess mail is retried for up to 72 hours.

Does this skill work with Twilio Email instead of SendGrid?

No, this skill is scoped to SendGrid, identified by API keys starting with SG. or the app.sendgrid.com dashboard. For Twilio Email using comms.twilio.com with Account SID and Auth Token, use the twilio-email-deliverability-advisor skill instead.

Why are my emails blocked by Gmail or Yahoo?

Gmail, Yahoo, Microsoft, and Apple require DMARC for senders exceeding 5,000 messages per day, with SPF and DKIM required at all volumes. Check Google Postmaster Tools for Gmail reputation and expect high Yahoo deferrals when introducing new sending patterns.

How long does sender reputation recovery take?

Reputation repair takes 2-4 weeks of consistent good sending behavior, and there are no shortcuts. ISPs store reputation data for roughly 30 days, so IPs idle for over 30 days require re-warmup before resuming volume.