Content
66%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 a concise, command-first integration guide with good structure and no padding beyond a short intro paragraph, and it is appropriately self-contained for a single-CLI skill. Its main weakness is workflow clarity: the connect-then-run sequence lacks any validation or error-recovery checkpoints for operations that can mutate CRM data.
Suggestions
Add explicit validation checkpoints after `membrane connect` (confirm the connection id is present) and after `membrane action run`/`membrane request` (inspect the JSON output for errors before proceeding), especially for write/POST operations.
Include a brief feedback loop for the discovery workflow: if `membrane action list --intent=...` returns no matches, fall back to `membrane request` via the proxy, and vice versa.
Trim or relocate the introductory paragraph explaining what LionDesk is so the body stays lean and assumes Claude's existing knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, leading with executable CLI commands and a clean flag table; the only padding is the opening paragraph explaining what LionDesk is ('a CRM platform designed for real estate professionals...'), which is background Claude does not strictly need, keeping it just below 'lean and efficient' at 4. | 4 / 5 |
Actionability | It provides concrete, copy-pasteable commands throughout (install, login, search, connect, action list/run, request) with parameter examples and a flag table, which is mostly executable; the minor gap is that the discovery commands return IDs whose parsing is only loosely described ('Take the connector ID from output.items[0]...'), so it is not fully copy-paste-ready for every common case. | 4 / 5 |
Workflow Clarity | The connect/action/request flow is sequenced but validation is essentially absent: there is no checkpoint after `membrane connect` or `action run`, and the cap for batch/destructive operations without validation applies since `action run` and `membrane request` can mutate Liondesk data; this fits 'rough sequence present but many gaps; validation absent' better than 3. | 2 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview of the single integration surface with well-organized sections (Overview, Working with, Popular actions, Best practices) and no external bundle files to split off; per the simple-skill scoring note, a short well-structured body with no need for separate references earns a 5. | 5 / 5 |
Total | 15 / 20 Passed |