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 body is highly actionable with concrete CLI commands and a solid connection workflow, but it is padded with a marketing paragraph and a long entity list, and lacks validation checkpoints for destructive action/proxy operations. Organization is good for a single-file skill.
Suggestions
Remove the opening SaaS/marketing paragraph and trim or relocate the 30-item entity bullet list to cut tokens that do not aid execution.
Add an explicit validation checkpoint for destructive proxy/action calls (e.g., 'For -X DELETE, confirm the target id and inspect the response output/error field before proceeding') to lift workflow clarity above the cap.
Fix the 'Popular actions' section so it lists representative actions or remove it to eliminate the duplicated search-command guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The CLI command guidance is mostly efficient, but the opening marketing paragraph about who uses Mailbox Power and the ~30-item bullet list of entity types add unnecessary tokens Claude does not need, and the action-list command is stated twice. | 3 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands covering the common workflow (install, login, connection ensure, polling, action list/run, proxy) with a clear flags table, matching the comprehensive executable anchor. | 5 / 5 |
Workflow Clarity | The connection setup is well sequenced with a state-handling feedback loop (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but the action-running and proxy steps support destructive methods (e.g. DELETE) with no validation or verification checkpoint, capping this skill at 3 per the destructive-operations rule. | 3 / 5 |
Progressive Disclosure | A single self-contained file with clear section headers and no nested references; structure is good with only minor organization gaps such as the 'Popular actions' section that repeats the search command instead of listing actions. | 4 / 5 |
Total | 15 / 20 Passed |