Content
67%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, largely executable Membrane CLI guide with explicit connection-state validation checkpoints, but it is marred by a stray refusal line and an unrelated MDN link at the top and some redundant content. Cleaning those up and enumerating the workflow would lift it clearly into the top band.
Suggestions
Remove the opening 'I don't have enough information to do that...' line and the unrelated 'Official docs: https://developer.mozilla.org/.../eval' link — both are junk that waste tokens and confuse scope.
Number the end-to-end workflow (1. Install, 2. Authenticate, 3. Connect, 4. Wait for READY, 5. Discover actions, 6. Run/Proxy) and ensure the referenced 'Step 2' maps to a real header.
De-duplicate the action-discovery command: 'Popular actions' repeats `membrane action list` from 'Searching for actions' — merge them or make 'Popular actions' point to specific named actions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is efficient CLI commands, but the body opens with an irrelevant LLM-refusal line ('I don't have enough information to do that...') and an off-topic MDN eval link, and the 'Popular actions' section repeats the 'Searching for actions' command, adding avoidable noise that keeps it below the lean 4/5 anchors. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands for install, login, headless auth, connection ensure/poll, action list/run, and proxy requests with a flags table, but placeholder-heavy examples (CONNECTION_ID, QUERY) and the redundant action-list repetition leave minor gaps versus the fully comprehensive 5. | 4 / 5 |
Workflow Clarity | There is a clear install→authenticate→connect→poll-until-READY→search→run sequence with explicit state checkpoints (READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-after-action feedback loop, but 'Step 2' is referenced without a matching numbered header and the steps are not formally enumerated, so it falls short of the checklist-grade 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so this is a single-file skill; it is well-organized into clearly headed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with easy navigation, but at ~137 lines it exceeds the under-50-line simple-skill exception that would allow a 5, so it lands at 4. | 4 / 5 |
Total | 15 / 20 Passed |