Content
71%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.
Highly actionable content with excellent executable command documentation and a well-gated send workflow. The main costs are length from inlined reference material (server table, config reference, troubleshooting) and an internal contradiction between the pre-configured-accounts guidance and the create-a-.env section.
Suggestions
Resolve the configuration contradiction: mark the "Configuration Reference" section explicitly as the legacy `.env` fallback (or move it to a reference file) so it does not contradict the "Configuration is Pre-configured" instruction.
Move the provider server table, `.env` reference, and Troubleshooting into a `references/servers.md` (or similar) file, leaving SKILL.md as a lean command overview — the provider list currently appears three times in one file.
Trim Security Notes and the 163.com callout to a single authoritative mention instead of repeating the authorization-code guidance in three places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The command documentation is tight, but the body spends tokens on things Claude already knows or that duplicate other sections: the "Common Email Servers" host/port table, the annotated `.env` reference re-explaining TLS ports ("587 for STARTTLS, 465 for SSL"), Security Notes repeating the frontmatter provider list, and the provider roster appearing three times (intro line, table, 163.com callout). This is 'mostly efficient but includes some unnecessary explanation or could be tightened' — not 2, since there is no conceptual padding about what email or IMAP is, and every section does carry operational content. | 3 / 5 |
Actionability | Every subcommand has copy-paste-ready invocations with flags, defaults, and option semantics (`node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]`), and the send command includes five worked examples covering text, HTML, attachments, multiple recipients, and `--to-account`. All referenced scripts (imap.js, smtp.js) exist in the bundle. This fully matches the 'copy-paste ready, specific examples cover the common cases' anchor. | 5 / 5 |
Workflow Clarity | The risky operation (sending) has an explicit validation checkpoint — details must be reviewed with the user and sending is gated on `--confirmed` — plus post-send interpretation guidance (accepted ≠ delivered; call out `rejected`/`pending`), error-recovery direction (script errors route to LobsterAI Settings), and a troubleshooting section. Not 5 because the body contradicts itself on configuration: "Do NOT ask the user to create or edit these files" vs. a "Configuration Reference" section opening with "Create `.env` in the skill folder", which leaves the actual setup sequence ambiguous for the fallback path. | 4 / 5 |
Progressive Disclosure | Section structure is clean and all script references are real, but the SKILL.md is a ~250-line monolith inlining material that belongs in reference files: the full two-protocol CLI reference, the provider server table, the `.env` configuration reference, and troubleshooting could each be split out with one-level-deep pointers. The bundle contains only `scripts/` (imap.js, smtp.js, config.js, attachment-storage.js) — no `references/` — so the body has nowhere to offload detail. This matches 'some structure but content that should be separate is inline'; it is above 2 because headers are present and the inline material is at least well organized. | 3 / 5 |
Total | 15 / 20 Passed |