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 content is highly actionable and well-structured with a clear, checkpointed connection workflow; its main gaps are a slightly over-explanatory opening and the absence of result-verification guidance for destructive CRUD actions.
Suggestions
Cut the opening paragraph defining what Pipedrive/CRM is and the 'auth plumbing' aside to assume Claude's existing knowledge.
Add a verification step after running create/update actions (e.g. re-fetch the record or check the `output` field for the returned id) to close the feedback loop on destructive operations.
Consider moving the full Popular-actions and proxy-flag tables into a short reference file (e.g. ACTIONS.md) and linking to it, keeping only the most common examples inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, code-driven commands, but it opens by explaining what Pipedrive/CRM is ('Pipedrive is a CRM and sales management tool...') and includes minor padding like 'so you can focus on the integration logic rather than auth plumbing' that could be trimmed. | 4 / 5 |
Actionability | Every workflow step is backed by copy-paste-ready, executable commands (npm install, membrane login, connection ensure, action list/run, request) with concrete flags, --json output, and an input-passing example, covering the common cases. | 5 / 5 |
Workflow Clarity | The connect-and-wait flow is clearly sequenced with explicit checkpoints and feedback loops (poll --wait, READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR handling), but the destructive create/update action steps lack a verify-the-result checkpoint. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clearly labeled sections (Overview, Install, Auth, Connecting, Searching, Popular actions, Running, Proxy, Best practices), though the 20-row action table and proxy-flag table are bulk reference material kept fully inline with no offloaded reference file. | 4 / 5 |
Total | 17 / 20 Passed |