CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentmail

Email infrastructure for AI agents. Create accounts, send/receive emails, manage webhooks, and check karma balance via the AgentMail API.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/agentmail/SKILL.md

The canonical home for this skill is agentmail in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 highly actionable, information-dense skill body with executable REST and SDK examples, security-aware webhook verification, and well-sequenced polling workflows. Its weaknesses are moderate: content duplicated across curl and SDK presentations, and no progressive disclosure — the full API reference and types are inlined rather than offloaded to reference files.

Suggestions

Move the full endpoint table, TypeScript SDK section, and Types into a references/ file (e.g. REFERENCES.md), keeping SKILL.md as a quick-start overview with clearly signaled links.

Pick one primary integration style (curl or SDK) for the quick start and trim the duplicated operation-by-operation examples of the other.

Add explicit failure handling to the polling patterns (what to do after the loop exhausts its retries) to strengthen workflow feedback loops.

DimensionReasoningScore

Conciseness

The body is lean and API-specific with no padding explaining concepts Claude already knows; every section carries non-obvious information (karma rules, webhook security headers, endpoint table). It falls short of anchor 5 because each operation is demonstrated twice (curl and TypeScript SDK) and the two polling patterns could be tightened, which is minor trimmable duplication rather than full verbosity.

4 / 5

Actionability

Fully executable, copy-paste-ready curl commands with headers, JSON bodies, and sample responses; complete TypeScript SDK snippets including error handling with `e.status`/`e.code`; and working polling loops in the common patterns. These cover the common cases the skill is designed for, matching the anchor-5 example.

5 / 5

Workflow Clarity

The multi-step patterns (signup → poll for verification email; send → poll for reply) are clearly sequenced with explicit validation checkpoints (find the verification/reply, then fetch detail and break), plus error-recovery guidance via `AgentMailError` status/code and the rule "Always check balance before operations that cost karma". It is not anchor 5 because the polling loops lack explicit failure handling after max iterations and the destructive delete operation has no pre-deletion validation step — but it does not fall to 3 since the presented workflows do include verification checkpoints.

4 / 5

Progressive Disclosure

The file is well-sectioned but is a ~240-line monolith with the full API reference table, TypeScript SDK guide, types, and patterns all inlined in SKILL.md, and no references/ bundle files exist. This matches anchor 3 — structure present, but content that belongs in separate reference files (the endpoint table, types, SDK details) is inline rather than split into clearly signaled one-level-deep references.

3 / 5

Total

16

/

20

Passed

Description

66%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 solid description with concrete, third-person action statements and a clearly named domain. Its main weakness is the absence of any explicit 'Use when...' trigger guidance, which caps completeness and weakens its usefulness for skill routing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the agent needs an email address, to send or receive email, or to read verification codes".

Include a few more natural synonyms such as "inbox", "email address", and "verification codes" to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Create accounts, send/receive emails, manage webhooks, and check karma balance via the AgentMail API" — naming the domain and multiple specific capabilities. It stops short of anchor 5 because "manage webhooks" is generic phrasing and the coverage, while good, is summarized rather than comprehensive (no mention of attachments or verification-email use cases).

4 / 5

Completeness

It has a clear "what" (email infrastructure with enumerated capabilities) but no "when" clause or equivalent trigger guidance (no "Use when..." phrasing). Per the judging guideline, a missing 'Use when...' clause caps completeness at 3, which applies here.

3 / 5

Trigger Term Quality

Natural terms like "email", "send/receive emails", "webhooks", and "AI agents" are present and match what a user would say. It falls short of anchor 5's comprehensive synonym coverage — common phrasings like "inbox", "email address", "verification code", or "attachments" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — "karma balance", "AgentMail API", and "AI agents" are unlikely to fire for unrelated skills, and the good-example pattern of named-domain + concrete actions is followed. It is not anchor 5 because "send/receive emails" is a capability other email skills could also claim, giving minor overlap risk with closely related skills.

4 / 5

Total

15

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/agentmail/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.