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 body is a strong, actionable integration guide built almost entirely from executable Membrane CLI commands with a clear connection-state workflow. Its main weaknesses are minor verbosity in the intro, slightly inconsistent step numbering, and a monolithic single-file structure with no progressive disclosure into reference files.
Suggestions
Trim the opening marketing paragraph and editorializing asides (e.g. "so you can focus on the integration logic rather than auth plumbing") to assume Claude's competence.
Fix the step numbering: replace the orphaned "1b" subsection and "skip to Step 2" references with a consistent Step 1 / Step 2 / Step 3 sequence for the connect-search-run flow.
As the skill grows, move the report taxonomy and the proxy flag reference table into separate reference files (e.g. REPORTS.md, PROXY.md) referenced from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by concrete, copy-pasteable commands and a tight report taxonomy, with only minor padding such as the marketing-style opening paragraph ("engineering intelligence platform that provides data-driven insights...") and editorial lines like "so you can focus on the integration logic rather than auth plumbing". | 4 / 5 |
Actionability | It provides fully executable, copy-paste-ready commands for every stage (install, login, connection ensure, connection get --wait, action list/run, request proxy) plus a flag table, covering the common cases with explained placeholders. | 5 / 5 |
Workflow Clarity | The connection lifecycle is clearly sequenced with state-based branching (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-after-action feedback loop, but step labels are inconsistent — it references "Step 2" and a "1b" subsection without a matching numbered step structure. | 4 / 5 |
Progressive Disclosure | With no bundle files present, all content lives inline in a single well-sectioned SKILL.md (Overview, Working with Waydev, Install, Auth, Connecting, Searching, Popular actions, Best practices) that is easy to navigate, though some content (the report taxonomy or proxy flag reference) could be split into reference files as the skill grows. | 4 / 5 |
Total | 17 / 20 Passed |