CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-email-inbox

Use when building any system where email content triggers actions — AI agent inboxes, automated support handlers, email-to-task pipelines, or any workflow processing untrusted inbound email. Always use this skill when the user wants to receive emails and act on them programmatically, even if they don't mention "agent" — the skill contains critical security patterns (sender allowlists, content filtering, sandboxed processing) that prevent untrusted email from controlling your system.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable content with a clear, well-validated workflow and a genuinely useful reference bundle. The weaknesses are redundancy within the body (duplicated security guidance and Level 1 code) and promotional/verbose sections that could be trimmed or moved to references.

Suggestions

Merge the 'Always Do / Never Do' tables into the 'Common Mistakes' table — they cover the same ground twice in ~25 lines.

Drop or compress the 'Why Webhook-Based Receiving?' bullets; the rationale is evident to Claude from the architecture diagram.

Move the multi-language SDK version table and one of the two full webhook framework examples into a reference file to slim the body and remove the Level 1 code duplicated in security-levels.md.

DimensionReasoningScore

Conciseness

The body is mostly dense and table-driven, but contains several padded or redundant sections: the 'Why Webhook-Based Receiving?' pitch bullets, the 8-language SDK version table, and 'Always Do / Never Do' tables that substantially duplicate the later 'Common Mistakes' table. Level 1 code is inlined and repeated in references/security-levels.md.

3 / 5

Actionability

Fully executable Next.js and Express webhook handlers with signature verification, inbox-creation and thread-reply code, exact error semantics (401 restricted_api_key, 403, 422), concrete env vars, Resend test addresses, and a curl verification checklist — copy-paste ready and covering the common cases.

5 / 5

Workflow Clarity

An 8-step Quick Start with explicit gating ('Ask the user and wait for their response', choose security level before webhook code), error-recovery feedback loops (return 500 so Resend retries vs 200 to acknowledge rejected mail), and a testing checklist with troubleshooting delegated to a reference.

5 / 5

Progressive Disclosure

Three well-signaled, one-level-deep references (security-levels.md, webhook-setup.md, advanced-patterns.md) — all real files with their own TOCs and no deeper nesting — with the body summarizing Level 1 and delegating Levels 2-5. Held at 4 because the ~460-line body duplicates reference content (Level 1 code) and inlines two full framework examples plus the version table that could live in references.

4 / 5

Total

17

/

20

Passed

Description

77%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 with excellent, explicit trigger coverage and clear domain framing. Its main weakness is that the 'what' describes scope and contained patterns rather than the concrete capabilities the skill provides.

Suggestions

State one or two concrete deliverables in the 'what' clause (e.g., creating a Resend inbox, handling inbound-email webhooks, replying within threads) so the skill's function is explicit, not just its scope.

Tighten the broad trigger 'any system where email content triggers actions' toward receiving/acting contexts to reduce overlap with send-only email workflows.

DimensionReasoningScore

Specificity

The description names the domain richly ('AI agent inboxes, automated support handlers, email-to-task pipelines') and lists concrete security patterns ('sender allowlists, content filtering, sandboxed processing'), but it describes scope rather than the skill's actions — no mention of inbox creation, webhook endpoints, or thread replies.

3 / 5

Completeness

Both 'what' ('contains critical security patterns... that prevent untrusted email from controlling your system') and an explicit 'when' ('Use when building any system where email content triggers actions... Always use this skill when the user wants to receive emails') are present. Not a 5 because the 'what' states contained patterns but not what the skill helps the user build or do.

4 / 5

Trigger Term Quality

Comprehensive natural-term coverage: 'AI agent inboxes', 'automated support handlers', 'email-to-task pipelines', 'receive emails and act on them programmatically', 'untrusted inbound email', plus an explicit catch for users who don't say 'agent'. No common synonym of the niche is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche of inbound email triggering agent action, distinct from send-only email skills; but 'any system where email content triggers actions' is broad enough to overlap with send/notification-pipeline skills, and there is no vendor scoping to further separate it.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (511 lines); consider splitting into references/ and linking

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

resend/resend-skills

Path

skills/agent-email-inbox/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.