CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

email-best-practices

Use when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM, GDPR, CASL), handling webhooks, retry logic, making emails accessible (alt text, headings, contrast, screen readers), or deciding transactional vs marketing.

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

86%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 lean, well-organized router: an architecture diagram with embedded checkpoints and feedback loops, a complete need-to-file table, and clear task-based entry paths pointing at one level of real, verified reference files. The only improvement space is an inline quick-start snippet and explicit verification steps in the Start Here paths.

DimensionReasoningScore

Conciseness

The ~55-line body is lean: no concept explanations Claude already knows, no padding — every element (architecture diagram, Quick Reference table, Start Here paths) routes to a specific reference file. It matches anchor 5 ('every token earns its place') with nothing trimmable down to anchor 4.

5 / 5

Actionability

Concrete, executable routing: 'Check Deliverability first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails', plus ordered paths like 'Email Capture (collect consent) → Compliance (legal requirements) → Marketing Emails'. Falls short of anchor 5 because the body contains no copy-paste-ready code or commands (e.g., a sample SPF DNS record) — all executable detail is deferred one file deep; per the scoring notes, the absence of code itself is not penalized, only the missing quick-start snippet.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced: the architecture diagram shows a pre-send checkpoint ('Suppression Check' before 'Ready to Send') and feedback loops (Bounced/Complained events → 'Suppression List Updated' → 'List Hygiene Jobs'), and Start Here gives ordered reading paths. Not anchor 5 because the task paths carry no explicit verification steps of their own (deferred to references); not anchor 3 because checkpoints are shown, not merely implicit.

4 / 5

Progressive Disclosure

Exemplary router structure: a Quick Reference table mapping 11 needs to 11 files, task-based entry paths in Start Here, and one-level-deep references — all 11 referenced files verified present in references/ with substantive content, with no missing or orphaned files. Matches anchor 5 exactly.

5 / 5

Total

18

/

20

Passed

Description

70%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 rich, natural trigger list with excellent specificity, keyword coverage, and email-niche distinctiveness. Its one structural flaw is that it is purely a 'Use when…' clause with no statement of what the skill actually provides, which caps completeness at the low band despite otherwise strong content.

Suggestions

Prepend an explicit 'what' statement, e.g. 'Provides best-practice guidance for building deliverable, compliant, user-friendly emails (authentication, capture, compliance, sending reliability, accessibility). Use when…' — this alone would raise completeness from 2 to 5.

State the skill's output form (reference guides/playbooks per topic) so the 'what' is explicit rather than left to inference.

Scope the generic triggers to the email domain ('handling email webhooks', 'retry logic for email sends') to reduce overlap risk with general webhook/retry skills.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete, specific items — 'setting up SPF/DKIM/DMARC authentication', 'implementing email capture', 'ensuring compliance (CAN-SPAM, GDPR, CASL)', 'handling webhooks, retry logic', 'making emails accessible (alt text, headings, contrast, screen readers)', 'deciding transactional vs marketing' — with comprehensive coverage across deliverability, capture, compliance, reliability, and accessibility. It exceeds anchor 4 ('minor gaps in coverage') because no significant email-domain concern is left out.

5 / 5

Completeness

The entire description is a single 'Use when…' clause — the 'when' is thorough, but no 'what' statement exists (nothing says the skill provides guidance, code, or checks). This matches anchor 2's 'only when is present without what' clause exactly, and the guidelines forbid inferring a 'what' that would justify anchor 3.

2 / 5

Trigger Term Quality

It uses natural phrases users actually say ('emails going to spam', 'high bounce rates') alongside synonym clusters ('alt text, headings, contrast, screen readers') and named regulations, matching the comprehensive-with-synonyms anchor 5. It is above anchor 4 because no common natural phrasing for the domain is conspicuously missing.

5 / 5

Distinctiveness Conflict Risk

Distinctive email-specific triggers (SPF/DKIM/DMARC, CAN-SPAM/GDPR/CASL, transactional vs marketing) establish a clear niche, but the generic items 'handling webhooks, retry logic' could fire for non-email webhook/retry questions — minor overlap risk with closely related skills, per anchor 4. Not anchor 5 because those generic triggers are not fully scoped to email.

4 / 5

Total

16

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

resend/resend-skills

Path

skills/email-best-practices/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.