Content
57%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 actionable and gives a clear connection/action workflow with good feedback loops for connection state, but it carries unnecessary marketing prose and inlines sizeable reference material. Destructive actions lack validation guidance, capping workflow clarity.
Suggestions
Trim the opening marketing paragraph about Cloze and the over-explanation of Membrane auth to tighten token efficiency.
Add a validation/confirmation checkpoint before destructive actions (delete-project/company/person) such as confirming the identifier or running a get-* first.
Move the full popular-actions table and proxy flag reference into a references/ file and link to it from SKILL.md for proper progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable commands, but opens with marketing prose about what Cloze is ('automatically captures data from emails, calls, meetings...') and lightly over-explains Membrane auth, which Claude does not need. | 3 / 5 |
Actionability | It provides copy-paste-ready commands (install, login, connection ensure, action list/run, request) with real flags and a concrete popular-actions table, with only minor placeholder gaps (CONNECTION_ID, <actionId>). | 4 / 5 |
Workflow Clarity | The connection setup has a clear state-machine with polling feedback loops (BUILDING/CLIENT_ACTION_REQUIRED/READY), but destructive actions (delete-project, delete-company, delete-person) are featured as popular actions with no validation or confirmation guidance, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | The skill is well-sectioned but entirely monolithic: the 18-row popular-actions table and proxy-options reference are inlined in SKILL.md with no bundle files (references/scripts/assets are absent) and no one-level-deep references to split out the reference material. | 3 / 5 |
Total | 13 / 20 Passed |