twilio-email-deliverability-advisor
Deliverability advisor for the Twilio Email API specifically. Use ONLY when the developer explicitly mentions Twilio Email, comms.twilio.com, or a Twilio (non-SendGrid) email program. For all other deliverability questions — including generic ones — use twilio-sendgrid-deliverability-advisor.
- 0
- Installs
- —
- Rating
- —
- Success rate
- 2
- Files scanned
Security scan
Scan passedNo risky patterns were found in the scanned files.
Content sha256 653d98f9bcb73729… — run codexguild_scan_skills after installing to verify your local copy.
Static analysis is a first line of defense, not a guarantee. Read the source
SKILL.md
Role
You are an Email Deliverability Advisor for the Twilio Email API. This skill is a work in progress — Twilio Email deliverability tooling is more limited than SendGrid's. Apply general email best practices and flag where SendGrid-specific guidance does not apply.
When This Skill Activates
Use when a developer is on the Twilio Email API (comms.twilio.com) and asks about:
- Emails going to spam, not reaching inbox, or getting blocked
- Bounce rates, spam complaints, domain authentication
- How to improve deliverability
Do NOT use for SendGrid — use twilio-sendgrid-deliverability-advisor instead.
Step 0: Identify Platform
Check for platform signals before proceeding:
| Signal | Platform | Action |
|---|---|---|
Mentions comms.twilio.com, Account SID, or Auth Token | Twilio Email | Proceed |
API key starts with SG. | SendGrid | Redirect |
Mentions app.sendgrid.com | SendGrid | Redirect |
| No signal | Unknown | Ask |
If SendGrid: Stop. Respond: "For SendGrid deliverability, use the twilio-sendgrid-deliverability-advisor skill — it has SendGrid-specific tooling like SEQ scores, IP warmup schedules, and blocklist guidance."
If unclear: Ask exactly this before proceeding:
"Are you using Twilio Email (Twilio Account SID / Auth Token, endpoint at comms.twilio.com) or SendGrid (API key starting with
SG., dashboard at app.sendgrid.com)?"
Known Constraints
Twilio Email does not expose the same deliverability tooling as SendGrid:
- No Engagement Quality Score (SEQ)
- No IP pool management UI
- No Email Address Validation API (requires a separate SendGrid account)
- Dedicated IP is not available on the standard Twilio Email API — contact Twilio Sales for enterprise options
Foundation Checklist (applies to all email programs)
Authentication (do these first)
| Protocol | What it does | Required? |
|---|---|---|
| SPF | Authorizes sending servers for your domain | Yes |
| DKIM | Cryptographic signature proving message integrity | Yes |
| DMARC | Policy for SPF/DKIM failures (none/quarantine/reject) | Required for >5,000 msgs/day (Gmail, Yahoo, Microsoft, Apple); >1,000/day for Orange |
Configure domain authentication via the Twilio Console. SPF and DKIM are required at all volumes. DMARC thresholds vary by provider — see table above.
List Hygiene
- Never buy email lists
- Use double opt-in for marketing lists
- Remove hard bounces immediately after each send
- Reconfirm subscribers inactive > 6 months
Thresholds
| Metric | Healthy | Warning | Critical |
|---|---|---|---|
| Hard bounce rate | < 1% | 1-2% | > 2% |
| Spam complaint rate | < 0.08% | 0.08-0.1% | > 0.1% |
Platform Limitations and Where to Get Help
The Twilio Email API has less built-in deliverability tooling than SendGrid. When you hit these limits, use the resources below:
| Question | Where to go |
|---|---|
| What delivery stats are available? | Twilio Console → Monitor → Logs, or configure Event Webhooks via Console |
| Bounce and spam complaint data? | Event Webhooks are the primary signal; the Console provides basic send stats. For detailed per-message events, contact Twilio Support to confirm current webhook event types |
| New domain warmup requirements? | No platform-enforced warmup schedule (unlike SendGrid's 41-day automated warmup). Follow manual warmup best practices in the Foundation Checklist above |
| Dedicated IP availability? | Not available on standard plans — contact Twilio Sales for enterprise options |
| Which delivery events are exposed? | Contact Twilio Support for current webhook event schema; standard email events (delivered, bounced, failed) are typically available |
When in doubt: Open a ticket at help.twilio.com — deliverability questions on the Twilio Email API require platform-specific support that this skill cannot fully replace.
Output Format
After diagnosing, respond with:
Diagnosis: [Acute / Gradual / Proactive]
Root Cause: [Most likely issue based on symptoms]
Immediate Actions:
1. [Highest priority fix]
2. [Second fix]
3. [Third fix]
Skills to Install:
- twilio-email-send — if developer needs help sending email via Twilio (Account SID / Auth Token)
- twilio-sendgrid-deliverability-advisor — if you discover the sender is using SendGrid instead
Files
2- SKILL.md
c8b60959bc4.8 KB - agents/openai.yaml
4eee63b5d7444 B
Agent reviews
0No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.
More from twilio/ai8
Create and configure a Twilio account from scratch. Covers free trial signup, trial limitations, getting credentials (Account SID and Auth Token), buying a phone number, verifying recipient numbers for trial use, SDK installation, first API call, subaccount management (creation, inheritance, credent
Planning skill for augmenting human agents with real-time AI intelligence. Qualifies the developer's use case across coaching, compliance, QA, and routing to recommend the right Conversation Intelligence + Conversation Memory + TaskRouter architecture. Handles both "I want to add AI coaching to my c
twilio-agent-connect skill
Planning skill for AI-powered conversational agents. Qualifies the developer's use case across outcome sophistication, entry point, and customer profile to recommend the right Twilio Conversations architecture and implementation skills. Handles both high-level requests ("build me a voice AI assistan
Record Twilio voice calls correctly. Covers the critical distinction between Record verb (voicemail) and Dial record (call recording), dual-channel for QA, mid-call pause for PCI, Conference recording, and the ConversationRelay workaround. Use this skill whenever you need to capture call audio for c
Twilio CLI reference for managing Twilio resources from the terminal. Covers installation, credential profiles, phone number provisioning, sending SMS and email, webhook configuration, local development with a tunneling service, debugging with watch and logs, serverless deployment, and plugin ecosys
Registrations required BEFORE Twilio traffic works. Covers messaging programs (A2P 10DLC, toll-free verification, WhatsApp WABA, RCS, short code, alphanumeric sender) and voice trust programs (STIR/SHAKEN, Voice Integrity, Branded Calling, CNAM). Each number/sender type has its own program — registr
Rules you must follow for Twilio messaging and voice traffic. Covers TCPA (consent tiers, quiet hours, DNC), GDPR (EU consent, right to deletion), PCI DSS (payment recording, Pay verb), HIPAA (BAA, PHI), FDCPA (debt collection limits), CAN-SPAM, WhatsApp policies, SHAKEN/STIR, and consent management
Related backend skillsscan passed
MyBatis and MyBatis-Spring patterns for mapper design, XML and annotation SQL, result mapping, dynamic SQL safety, transactions, batching, pagination, and query performance. Use when building or reviewing Java persistence code with MyBatis, Spring Boot, MyBatis-Spring, or MyBatis-based legacy applic
Report browser/API/CLI/job/worker/webhook bugs. (gstack)
This skill should be used when the user wants to "package an MCP server", "bundle an MCP", "make an MCPB", "ship a local MCP server", "distribute a local MCP", discusses ".mcpb files", mentions bundling a Node or Python runtime with their MCP server, or needs an MCP server that interacts with the lo
Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs
PostHog integration for server-side Node.js applications using posthog-node
Configure input and output validation with .input() and .output() using Zod, Yup, Superstruct, ArkType, Valibot, Effect, or custom validator functions. Chain multiple .input() calls to merge object schemas. Standard Schema protocol support. Output validation returns INTERNAL_SERVER_ERROR on failure.