Content
92%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |