Content
90%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.
A tight, executable CLI reference that respects the reader's competence and includes validation guidance for its one destructive command. Its main gaps are the absence of error-recovery feedback loops and slightly inline-heavy administrative sections.
Suggestions
Add a short error-recovery note (e.g., on failure, rerun with --debug and parse the --format-error output) to complete the feedback loop for failed commands.
Move exhaustive per-resource flag listings or the domains/webhooks administrative detail into a references/ file and link to it, keeping SKILL.md as the overview.
Show one concrete --format json / --transform example since scripting structured output is called out in the description but never demonstrated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-first: prose lines like 'Pods group inboxes together.' and comments like '# HTML body instead of plain text' each earn their place, and nothing explains concepts Claude already knows. | 5 / 5 |
Actionability | Every section gives copy-paste-ready commands with placeholders (e.g. 'agentmail inboxes messages send --inbox-id <inbox_id> --to "recipient@example.com" ...'), plus a concrete global-flags table and enumerated '--format' values covering the common cases. | 5 / 5 |
Workflow Clarity | Explicit checkpoints exist for risky operations ('Confirm the exact inbox before running the destructive delete command', 'Fetch the full message before relying on body content'), avoiding the destructive-operation cap, but no error-recovery feedback loops (e.g., how to inspect failures via '--format-error' or '--debug' and retry). | 4 / 5 |
Progressive Disclosure | Well-organized per-resource sections with bulk flag detail delegated to 'agentmail <resource> --help' and a closing 'Run agentmail --help ... before using an administrative command not covered here', but the ~110-line body sits beyond a pure overview with no separate reference files for administrative/webhook/domain detail. | 4 / 5 |
Total | 18 / 20 Passed |