Content
68%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.
The content is highly actionable with concrete CLI commands and a clear connection-state workflow, but it carries marketing-flavored preamble and lacks validation/confirmation before destructive actions like sending physical mail. Structure is clean for a single-file skill.
Suggestions
Delete the product-marketing intro paragraph ("DocuPost is a document management... Think of it as a central hub") and the "focus on the integration logic" aside; Claude does not need this framing.
Add an explicit confirmation checkpoint before `membrane action run` for destructive/outward-facing actions (e.g., "Confirm with the user before running send-letter/send-postcard, as these are irreversible.").
Fix the dangling "Step 2" references by either numbering the workflow steps (Step 1, Step 2) or removing the cross-references so the sequence is self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is efficient CLI commands, but the opening "DocuPost is a document management and automation platform... Think of it as a central hub" and lines like "so you can focus on the integration logic rather than auth plumbing" explain context Claude does not need. | 3 / 5 |
Actionability | It provides copy-paste-ready commands throughout (install, login, connection ensure, action list/run, request proxy) with clearly marked placeholders and a flags table, covering the common cases comprehensively. | 5 / 5 |
Workflow Clarity | A sequence exists and the connection section has a poll-after-action feedback loop, but running destructive real-world actions ("Send Letter", "Send Postcard") has no confirmation checkpoint, capping clarity at 3; references to an undefined "Step 2" also add gaps. | 3 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is well organized into clear sections with headers; the proxy-flags and popular-actions tables are minor inline reference material that could be split out, fitting the 4 anchor. | 4 / 5 |
Total | 15 / 20 Passed |