CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mailtrap-email-integration

Guides agents through integrating transactional email sending via Mailtrap's Email API, including sandbox testing, domain verification, and API authentication. Use when implementing email-sending features, debugging delivery issues, or setting up safe dev/staging email testing.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

68%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 well-built, information-dense skill body: executable code, genuinely non-obvious domain facts, and a useful anti-patterns table. Its main weakness is that it reads as a reference rather than a workflow — the integration sequence and its validation checkpoints are left implicit.

Suggestions

Add a short ordered 'Integration workflow' section (e.g., 1. create sandbox inbox + token, 2. route non-production sends to the sandbox endpoint, 3. add SPF/DKIM/DMARC records and confirm verification, 4. switch production to the verified sending domain) so the sequence is explicit rather than implied.

Include validation checkpoints in that workflow: how to confirm a sent message arrived in the sandbox inbox and how to verify domain verification completed before enabling production sending.

Show a full sandbox send example (not just the endpoint ternary), e.g., the same fetch call parameterized by the sandbox URL with inbox ID, so both environments are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is lean and nearly every sentence carries Mailtrap-specific, non-obvious information (sandbox endpoint pattern, per-project scoped tokens, SPF/DKIM/DMARC verification requirement). Only minor trimmable material remains — e.g., "Treat email sending as a fallible network call: wrap in try/catch, never assume success" restates what Claude already knows, and the Best Practices bullets partially restate the anti-patterns table. This matches anchor 4 ('efficient; minor instances of over-explanation') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

The production send example is complete, executable TypeScript with the real endpoint, auth header, env-based token, body shape, and error check, plus a concrete sandbox routing snippet. Minor gaps keep it below anchor 5: the sandbox path shows only the endpoint ternary rather than a full send call, and there are no commands for actually verifying a domain or listing sandbox messages. Anchor 5 requires the common cases fully covered copy-paste ready.

4 / 5

Workflow Clarity

The content is organized as concepts → code → anti-patterns rather than a sequenced integration workflow; the natural order (obtain sandbox token → route non-production to sandbox → verify domain DNS records → enable production sending → validate delivery) is only implicit, and there are no validation checkpoints (e.g., how to confirm domain verification succeeded or check a message landed in the sandbox inbox). This matches anchor 3 ('sequence present but implicit, checkpoints missing'). It is not a destructive/batch skill, so no hard cap applies, and the scattered but present ordering keeps it above anchor 2's 'rough sequence with many gaps'.

3 / 5

Progressive Disclosure

The body is a well-organized, self-contained ~70-line overview with clear section headers and no nested or buried references; there are no bundle files, and nothing here clearly demands extraction to a separate reference file. It sits between the 'under 50 lines with well-organized sections' 5-anchor and anchor 4's 'good structure; minor organization gaps' — the size is slightly above the simple-skill threshold and the 'Related Skills' section lists bare names without paths, so 4 is the best fit.

4 / 5

Total

15

/

20

Passed

Description

87%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.

A strong description: third-person voice, concrete named capabilities, and an explicit 'Use when' clause with natural trigger phrases. The only soft spot is trigger-term coverage, which omits a few common phrasings users might type.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "integrating transactional email sending via Mailtrap's Email API, including sandbox testing, domain verification, and API authentication" — but has minor coverage gaps (e.g., no mention of debugging/inspection tooling or templates). It sits between anchor 4 ('several specific actions; minor gaps') and anchor 5, closer to 4.

4 / 5

Completeness

It explicitly answers both: what it does ("Guides agents through integrating transactional email sending via Mailtrap's Email API, including sandbox testing, domain verification, and API authentication") and when to use it ("Use when implementing email-sending features, debugging delivery issues, or setting up safe dev/staging email testing") with concrete trigger phrases. This matches the anchor-5 exemplar structure exactly; anchor 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

The 'Use when' clause supplies natural phrases users would say — "implementing email-sending features", "debugging delivery issues", "setting up safe dev/staging email testing" — but misses common variations like plain "send email", "emails not arriving", or "SMTP". Good coverage with a few natural terms missing, matching anchor 4 rather than the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a named vendor and product surface ("Mailtrap's Email API", "sandbox", "domain verification"), giving it a clear niche with distinct triggers and minimal overlap risk with generic email or notification skills. It clearly fits anchor 5; anchor 4's 'minor overlap risk with closely related skills' does not apply since the Mailtrap-specific terms disambiguate it.

5 / 5

Total

18

/

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

affaan-m/ECC

Path

skills/mailtrap-email-integration/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.