Content
65%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.
A highly actionable CLI-driven skill: commands are concrete and executable throughout, with good error-state handling for connection setup. The main weaknesses are a broken step numbering scheme (dangling "Step 2" references), missing validation guidance for destructive booking operations, and some trimmable prose.
Suggestions
Fix the incoherent step references: either number the workflow explicitly (1. Install, 2. Authenticate, 3. Connect, 4. Discover actions, 5. Run actions) or remove the "Step 2" and "1b" labels entirely.
Add a validation checkpoint before destructive actions (cancel-booking, update-booking), e.g. verify the booking details with get-booking and confirm with the user before running cancel.
Trim marketing prose ("focus on the integration logic rather than auth plumbing", "burn less tokens") and consider moving the full action catalog and clientAction schema details into a reference file to slim the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean (commands, tables, brief explanations), but there is unnecessary prose that could be trimmed: the marketing-flavored sentences ("you can focus on the integration logic rather than auth plumbing", "This will burn less tokens and make communication more secure") and the low-value "10to8 Overview" bullet tree of app entities. | 3 / 5 |
Actionability | Every section provides copy-paste-ready commands: install (npm install -g @membranehq/cli@latest), login, connection ensure, polling with --wait, action list/run with concrete --input JSON examples, and the proxy command with a full options table. The popular-actions table with keys makes the catalog directly usable. | 5 / 5 |
Workflow Clarity | The overall sequence (install → login → ensure connection → poll states → search actions → run → proxy fallback) is present and the connection-state handling (READY/CLIENT_ACTION_REQUIRED/error) forms a decent feedback loop, but the flow references "**Step 2**" twice and labels a section "#### 1b." with no defined Step 1 or Step 2. Destructive actions (Cancel Booking, Update Booking) are offered with no validation/verification guidance, which caps this score at 3. | 3 / 5 |
Progressive Disclosure | The skill is a single ~160-line file with no bundle files (references/, scripts/, assets/ are absent) and no one-level-deep references at all. Sections are clearly headed, but inline content like the 16-row popular-actions table and the clientAction reference details are the kind of material that could live in a separate reference file for a leaner SKILL.md. | 3 / 5 |
Total | 14 / 20 Passed |