Content
82%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 executable commands and a clear connection workflow, well-structured as a single overview file. The main gaps are minor: a few trimmable asides and the absence of an explicit error-recovery checkpoint when running actions or proxying requests.
Suggestions
Add a short validation/error-recovery note after `membrane action run` and `membrane request` (e.g. check the `output`/error fields and retry or surface `clientAction` guidance on failure) to close the workflow-clarity gap.
Trim editorial asides ("rather than auth plumbing", "burn less tokens") and de-duplicate the Kommo Overview entity list to tighten conciseness and structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with copy-paste commands, but includes minor padding such as "so you can focus on the integration logic rather than auth plumbing" and "This will burn less tokens and make communication more secure." Not a 5 because of these trimmable asides; not a 3 because the bulk is lean and assumes Claude's competence. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands across the common cases (login, connection ensure, action list/run, request proxy) plus a concrete options table. Not a 4 because there are no significant gaps in the executable guidance. | 5 / 5 |
Workflow Clarity | Clear install→authenticate→connect→discover→run sequence with a feedback loop for connection states (poll again after CLIENT_ACTION_REQUIRED, handle CONFIGURATION_ERROR). Not a 5 because the "Running actions" and "Proxy requests" sections lack an explicit validation/error-recovery checkpoint for failed action execution. | 4 / 5 |
Progressive Disclosure | A single well-organized SKILL.md with clear sections and no nested references; no bundle files exist so everything is appropriately inline. Not a 5 because the "Kommo Overview" list is redundantly nested (Lead/Contact/Company/Task repeated under Lead) and there is no "for X see Y" navigation to the official docs beyond a single top link. | 4 / 5 |
Total | 17 / 20 Passed |