Content
76%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 with executable Membrane CLI commands throughout and a well-structured connection workflow with polling feedback loops. Its main weakness is the absence of validation guidance around destructive delete operations, which caps workflow clarity.
Suggestions
Add a validation/verification step for destructive actions, e.g. confirm the record exists and prompt for confirmation before running delete-deal/delete-company/delete-contact, then verify deletion afterward.
Clarify the actionId vs. Key distinction in the popular-actions table so 'membrane action run <actionId>' maps unambiguously to the listed keys.
Trim the marketing-flavored intro and 'auth plumbing' phrasing to tighten conciseness from 4 toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean executable commands and tables, with only minor over-explanation (e.g. 'so you can focus on the integration logic rather than auth plumbing' and the marketing-style intro) that could be trimmed, fitting score 4 rather than 5. | 4 / 5 |
Actionability | It provides copy-paste-ready commands for install, auth, connection, action search/run, and proxying, plus a concrete actions table and flag reference, fully covering the common cases per the score-5 anchor. | 5 / 5 |
Workflow Clarity | The connect→search→run sequence is clear with state-based polling feedback loops, but destructive operations (delete-deal, delete-company, delete-contact) appear in the action table with no validation or verification checkpoint, capping workflow clarity at 3 per the destructive-ops guideline. | 3 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is organized into clear headed sections covering overview, setup, actions, and best practices; the large inline actions table is borderline but acceptable, giving score 4 rather than 5 since some reference material could live in a separate file. | 4 / 5 |
Total | 16 / 20 Passed |