CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/twilio-developer-kit/skills/twilio-email-deliverability-advisor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, table-driven advisory skill that is rich in non-obvious platform specifics and honest about Twilio Email's tooling gaps, with excellent platform-routing logic. Its main weaknesses are an undefined Acute/Gradual/Proactive diagnostic taxonomy invoked by the output template, an unsequenced post-Step-0 workflow, and duplicated constraint content across two sections.

Suggestions

Define the Acute/Gradual/Proactive diagnosis taxonomy (or link the symptom patterns from the 'When This Skill Activates' section to it) — the output format currently requires a classification the body never explains.

Number the diagnostic steps after Step 0 (e.g., Step 1: gather signals from Event Webhooks/Console logs → Step 2: run the Foundation Checklist → Step 3: classify diagnosis → Step 4: emit output format) so the sequence to the output template is explicit.

Merge 'Known Constraints' into the 'Platform Limitations and Where to Get Help' table — they state the same facts (SEQ/IP pools absent, dedicated IP via Sales) twice in adjacent sections.

DimensionReasoningScore

Conciseness

The body is table-driven and dense with non-obvious specifics (DMARC thresholds per provider, bounce/complaint thresholds, warmup absence), with no explanation of concepts Claude already knows. It is not a 5 because of redundancy: the 'Known Constraints' section and the 'Platform Limitations and Where to Get Help' table repeat the same facts (no IP pool/SEQ tooling, dedicated IP via Sales, support contact) twice within ~40 lines, and the SendGrid redirect appears three times in the body.

4 / 5

Actionability

Concrete, executable guidance dominates: exact redirect response text, an exact clarifying question, specific numeric thresholds (< 1% hard bounce, < 0.08% complaints), console navigation paths, and a copy-paste output template. It stops short of a 5 because the remediation guidance stays at instruction level — 'Configure domain authentication via the Twilio Console' and 'Remove hard bounces immediately after each send' give no specific steps, commands, or links for how to do these on the Twilio platform.

4 / 5

Workflow Clarity

Platform identification (Step 0) is excellently structured with a signal table, explicit redirect script, and fallback question, but the diagnostic workflow after it is not sequenced: only Step 0 is numbered, and the output format demands 'Diagnosis: [Acute / Gradual / Proactive]' — a taxonomy the body never defines or explains how to derive. This matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' rather than the level-4 anchor's 'most checkpoints present'.

3 / 5

Progressive Disclosure

This is a self-contained skill with no bundle files (references/, scripts/, assets/ are absent) and no dangling references — every link is an external support URL and every cross-skill mention is a sibling skill name, all real. All content fits comfortably in one file at ~100 table-heavy lines, and sections are clearly headed and well-organized, which per the rubric's simple-skill guidance earns full marks with no need for external reference files.

5 / 5

Total

16

/

20

Passed

Description

61%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exceptionally well-bounded description that eliminates conflict risk with its sibling SendGrid skill, but it spends its token budget on routing logic rather than telling the reader what the skill actually does or what problems it solves. Adding one sentence of concrete capabilities and natural problem terms (spam, bounces, inbox placement) would lift specificity and trigger quality substantially.

Suggestions

Enumerate 2-4 concrete capabilities in the description (e.g., 'diagnoses spam placement, reviews bounce and complaint rates, checks SPF/DKIM/DMARC setup') instead of the generic role label 'Deliverability advisor'.

Include the natural problem phrases users actually say — 'emails going to spam', 'bounces', 'blocked or not reaching the inbox' — which currently appear only in the body's activation section.

Keep the explicit ONLY-when routing clause as-is; it is the description's strongest asset.

DimensionReasoningScore

Specificity

The description names the domain ("Deliverability advisor for the Twilio Email API specifically") but names essentially no concrete actions — there is no equivalent of "extracts text" or "fills forms"; what an advisor actually does (diagnose spam placement, check SPF/DKIM/DMARC, review bounce rates) is never stated. This matches the anchor 'Names the domain but actions are minimal or generic' rather than the level-3 anchor, which requires 1-2 concrete named actions.

2 / 5

Completeness

Both parts are present: 'what' ("Deliverability advisor for the Twilio Email API") and an unusually explicit 'when' ("Use ONLY when the developer explicitly mentions Twilio Email, comms.twilio.com, or a Twilio (non-SendGrid) email program"). It falls short of a 5 because the 'what' remains a role label rather than a concrete statement of what the skill does, which is exactly the residual weakness the level-4 anchor describes.

4 / 5

Trigger Term Quality

Platform triggers are strong ("Twilio Email", "comms.twilio.com", "Twilio (non-SendGrid) email program") but the natural problem-domain phrases a user would say — emails going to spam, bounces, blocked, not reaching the inbox — are entirely absent from the description (they only appear in the body). This is 'Some relevant keywords but missing common variations or synonyms' rather than good coverage.

3 / 5

Distinctiveness Conflict Risk

The description is explicitly anti-conflict: 'Use ONLY when the developer explicitly mentions Twilio Email... For all other deliverability questions — including generic ones — use twilio-sendgrid-deliverability-advisor.' This carves out a clear niche with distinct triggers and actively routes the nearest competing skill away, satisfying the level-5 anchor 'Clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/twilio-developer-kit/skills/twilio-email-deliverability-advisor/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.