Content
67%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 well-structured, mostly actionable guide to driving AmoCRM through the Membrane CLI, with a strong state-machine-based connection flow. Its main weaknesses are a padded introductory paragraph explaining concepts Claude already knows and some inconsistent step numbering that slightly muddies the workflow.
Suggestions
Remove or trim the opening 'AmoCRM is a customer relationship management platform...' paragraph; assume Claude knows what a CRM is and lead directly with the integration purpose.
Fix the step numbering: label the action-search/run section as 'Step 2' so the 'skip to Step 2' reference resolves, and add a '1a' or relabel '1b' to a non-numbered heading.
Add a brief validation note in the 'Running actions' section for error responses (e.g., check the JSON output for error fields and re-query the action's inputSchema) to close the loop on failed action calls.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI commands, but the opening paragraph ('AmoCRM is a customer relationship management platform geared towards sales teams...') explains what AmoCRM is — context Claude does not need — and a few sentences carry light padding. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready membrane commands (login, connection ensure, action list/run, request) with real flags and JSON examples; a few placeholders like /path/to/endpoint keep it just short of fully executable for all cases. | 4 / 5 |
Workflow Clarity | The connection flow is sequenced with a state machine (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and polling feedback loops, but numbering is inconsistent ('Step 2' is referenced but unlabeled, '1b' appears without a '1a'). | 4 / 5 |
Progressive Disclosure | No bundle files are present, but the single SKILL.md is well-organized into clear sections (Install, Authentication, Connecting, Searching actions, Proxy, Best practices) with content appropriately placed in one file. | 4 / 5 |
Total | 15 / 20 Passed |