Content
61%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 well-structured, actionable guide to driving Google My Business through the Membrane CLI, with executable commands and a genuine connection-readiness feedback loop. Its main weaknesses are padding in the intro, a broken step reference, and missing validation guidance for the destructive actions it lists.
Suggestions
Remove or condense the opening paragraph explaining what Google My Business is; Claude already knows this and it consumes context unnecessarily.
Add a validation/verification checkpoint before destructive actions (e.g. 'Before delete-location, list-locations to confirm the target and confirm with the user') and fix the orphaned 'skip to Step 2' reference.
Provide one fully-worked end-to-end example (e.g. create-location with a realistic --input JSON payload and the expected output) to lift actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational CLI content Claude would not know, but it opens with padding Claude already knows ("Google My Business helps local businesses manage their online presence across Google, including Search and Maps...") and includes light marketing fluff ("so you can focus on the integration logic rather than auth plumbing"). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 4 because the intro paragraph is clearly removable. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands throughout (npm install, membrane login, connection ensure, action list/run, request) plus a popular-actions table with real keys and flag reference. It is not 5 because there is no fully-worked end-to-end example with realistic parameters for a representative action, leaving a minor gap in covering the common cases. | 4 / 5 |
Workflow Clarity | The connect → search → run sequence is clear and the connection-readiness branch (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) includes a real poll-and-re-poll feedback loop. However, the popular-actions table includes destructive operations (Delete Location, Delete Place Action Link) with no validation/verification guidance, which caps workflow clarity at 3 per the destructive-operations rule; a broken 'skip to Step 2' reference with no labeled Step 2 further weakens the sequence. | 3 / 5 |
Progressive Disclosure | No bundle files exist, and the body is organized into well-labeled sections (Overview, Working with GMB, Install, Auth, Connecting, Searching, Popular actions, Running actions, Proxy, Best practices) with easy navigation. It is not 5 because the skill exceeds 50 lines and the sizable popular-actions table is inlined rather than split into a separate reference, leaving minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |