CtrlK
BlogDocsLog inGet started
Tessl Logo

agentmail-mcp

Configure or troubleshoot the hosted AgentMail MCP server for Codex, Claude Code, Cursor, Claude.ai, ChatGPT, or another Streamable HTTP MCP client. Use for installation, OAuth, API-key headers, connection failures, or MCP tool discovery. Do not use when the connection already works and the user just wants to send, check, or manage mail — use the sibling action skills for that.

75

Quality

92%

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

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

An exemplary single-file skill body: copy-paste-ready configurations per client, precise auth options with security-conscious recommendations, a verification sequence with named smoke-test tools, and a troubleshooting section that maps real error messages to causes and fixes. The only nit is a duplicated caution about query-string credentials.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no generic MCP or OAuth explanations, just per-client config, exact paths, and error mappings. It falls just short of the every-token-earns-its-place anchor because the query-param caution is stated twice within the same section ("prefer a header so the key doesn't end up in logs or history" and then "Avoid query-string credentials when header authentication is available"), a minor trimmable redundancy.

4 / 5

Actionability

Fully executable throughout: copy-paste JSON configs with "${env:AGENTMAIL_API_KEY}" expansion, a ready "claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp" command, exact config-file paths per client, click-by-click connector menu paths, named smoke-test tools ("list_inboxes", "list_apps"), and concrete error-to-cause mappings (404 → missing /mcp, 401 → bad key or incomplete OAuth).

5 / 5

Workflow Clarity

The Verify section is a clear 4-step sequence with explicit validation checkpoints (restart, inspect MCP status and complete auth, read-only smoke test, confirm approval annotations), and the Troubleshoot section provides error-recovery feedback loops mapping each failure signature to its fix — matching the explicit-validation-plus-recovery anchor. No destructive or batch operations are involved, so no validation cap applies.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ all absent), and at ~100 focused lines nothing here warrants splitting into separate files; sections are well-labeled and navigable, external pointers (the mcp-manifest.json URL, the sibling agentmail-agentid and action skills) are clearly signaled one level deep, and the tool-catalog summary is kept appropriately brief.

5 / 5

Total

19

/

20

Passed

Description

92%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: it names the exact service, the clients it applies to, concrete setup/troubleshooting actions, and explicit positive and negative triggers. The only gap is a handful of natural synonyms (e.g., "set up", "sign in", "authenticate") that users might phrase differently.

DimensionReasoningScore

Specificity

"Configure or troubleshoot the hosted AgentMail MCP server" plus "installation, OAuth, API-key headers, connection failures, or MCP tool discovery" lists multiple concrete actions covering the skill's full scope, matching the comprehensive-coverage anchor rather than the score-4 anchor ("minor gaps") since no configuration or troubleshooting task is left out.

5 / 5

Completeness

The "what" is explicit ("Configure or troubleshoot the hosted AgentMail MCP server for [clients]") and the "when" is explicit with concrete trigger phrases ("Use for installation, OAuth, API-key headers, connection failures, or MCP tool discovery"), plus an explicit negative trigger boundary — clearly the both-answered-concretely anchor, not the score-4 anchor where the "when" is only loosely specified.

5 / 5

Trigger Term Quality

Natural triggers include client names users actually say ("Codex, Claude Code, Cursor, Claude.ai, ChatGPT"), "installation", "OAuth", "connection failures", and "MCP tool discovery" — good coverage, but common synonyms like "set up", "sign in", "authenticate", or "401" are missing, so it fits the good-coverage-with-a-few-gaps anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

"hosted AgentMail MCP server" carves a clear niche, and the negative guidance "Do not use when the connection already works and the user just wants to send, check, or manage mail — use the sibling action skills for that" actively routes away from sibling skills, minimizing conflict risk beyond even the clear-niche anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
stevenknowswhy/ProfessionalBuyer
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.