Content
63%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 concrete CLI commands and a sound connection workflow including a polling feedback loop. Its main weaknesses are a placeholder Overview section and duplicated/inconsistent guidance that hurt conciseness, plus an all-inline structure with no progressive disclosure for a skill of this length.
Suggestions
Remove or fill in the placeholder "Matterport Overview" section ("- **Model** / - **Note**") and trim the introductory Matterport background paragraph that Claude can infer, to tighten conciseness.
Fix the dangling "skip to Step 2" references by either adding a labeled Step 2 header or rewording to point at the actual section (e.g., "Searching for actions").
Consolidate the duplicated action-discovery guidance in "Searching for actions" and "Popular actions" into one section, and move the proxy-options table / clientAction detail into reference files to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes unnecessary padding: an introductory paragraph explaining what Matterport is, a placeholder "Matterport Overview" section ("- **Model** / - **Note**"), and duplicated action-discovery guidance in both "Searching for actions" and "Popular actions". It is not verbose enough for score 2 nor lean enough for score 4. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready commands throughout (install, login, connection ensure, action list/run, request proxy) covering the common cases. Minor gaps come from the vague placeholder Overview ("Use action names and parameters as needed") and an inconsistency between `membrane` and `npx @membranehq/cli@latest` invocations, keeping it just below score 5. | 4 / 5 |
Workflow Clarity | The connect -> poll-for-ready -> search-actions -> run sequence is clear and includes a real feedback loop (poll connection state, handle CLIENT_ACTION_REQUIRED, re-poll after user action). It falls short of score 5 because of broken "skip to Step 2" references with no corresponding Step 2 header and the absence of post-action validation. | 4 / 5 |
Progressive Disclosure | The skill is well over 50 lines with no bundle files or external references, so all detail lives inline — including the proxy-options table and the detailed clientAction object structure that could reasonably be split out. Structure exists via clear headers, but no content is offloaded to separate files, matching score 3 rather than score 4. | 3 / 5 |
Total | 14 / 20 Passed |