Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent actionable guidance with clear, executable CLI commands and a well-structured connection workflow with proper state handling and error recovery. However, it suffers from significant verbosity — the introductory explanation of ActiveProspect, the exhaustive resource listing, and some redundant descriptions inflate the token cost without adding value Claude needs. Trimming the overview and splitting reference material would substantially improve it.
Suggestions
Remove the introductory paragraph explaining what ActiveProspect is and who uses it — Claude doesn't need this context to execute the skill.
Remove or drastically condense the full resource/action overview listing (Person, Event, List, etc.) since `membrane action list --intent=QUERY` already provides dynamic discovery.
Move the proxy request details and flags table into a separate reference file to keep the main SKILL.md focused on the core workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph explains what ActiveProspect is and who uses it — information Claude doesn't need. The massive overview listing every resource and action (Person, Event, List, Form, Campaign, etc.) adds bulk without actionable value. There's also redundant explanation of Membrane's auth handling and general concepts. | 1 / 3 |
Actionability | The skill provides fully executable CLI commands for every step: installation, authentication, connection setup, action discovery, action execution, and proxy requests. Commands are copy-paste ready with clear parameter placeholders and flags documented in a table. | 3 / 3 |
Workflow Clarity | The connection workflow is clearly sequenced with explicit state-based branching (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR, SETUP_FAILED). There's a polling/retry loop for BUILDING state and clear instructions for what to do at each state transition, including error states. | 3 / 3 |
Progressive Disclosure | The content is reasonably structured with clear sections, but the large resource/action overview and the proxy request details could be split into separate reference files. Everything is inline in a single file with no bundle files to offload detail, making it longer than necessary for an overview. | 2 / 3 |
Total | 9 / 12 Passed |