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 with copy-paste-ready CLI commands and a sensible end-to-end workflow including a connection-readiness feedback loop. Main weaknesses are minor verbosity in the intro and a couple of dangling step references that break the otherwise clear sequence.
Suggestions
Trim the marketing-style intro paragraph ('comprehensive database... used by sales, marketing, and research teams') to a one-line factual purpose; Claude does not need the audience pitch.
Fix the dangling navigation: either label the post-connection section as 'Step 2' consistently or remove the 'skip to Step 2' / orphaned '1b' references in favor of a coherent numbered sequence.
Consider moving the 9-row Popular actions table to a references file so SKILL.md stays a lean overview, which would also tighten conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable commands and a useful actions table with only minor over-explanation (the marketing-style intro paragraph and phrases like 'so you can focus on the integration logic rather than auth plumbing'), fitting the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than the leaner level-5. | 4 / 5 |
Actionability | It provides copy-paste-ready commands for the full lifecycle (npm install, membrane login, connection ensure, action list/run, request proxy) with real flags and a concrete popular-actions table, matching the 'fully executable; specific examples cover the common cases' anchor. | 5 / 5 |
Workflow Clarity | The install → authenticate → connect → wait/search → run → proxy sequence is clear with an explicit connection-state feedback loop (poll until READY, handle CLIENT_ACTION_REQUIRED, re-poll), but dangling references like 'skip to Step 2' (no labeled Step 2) and the orphaned '1b' heading leave minor sequencing gaps that keep it below level 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so structure is assessed on the single SKILL.md; it is well-organized into clearly headed sections (Overview, Working with, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices) with no nested references, but at ~150 lines with a sizable inlined actions table it sits at 'good structure, minor organization gaps' rather than the level-5 lean-overview ideal. | 4 / 5 |
Total | 17 / 20 Passed |