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, actionable guide with concrete CLI commands and a genuine connection-state feedback loop, held back by some introductory padding and a couple of inconsistent step references.
Suggestions
Trim the introductory paragraph about what Uberduck is and lines like 'so you can focus on the integration logic rather than auth plumbing' to assume Claude's competence.
Fix the dangling step references: label the post-connection section 'Step 2' (or reword 'skip to Step 2') so the 1b / Step 2 navigation is coherent.
Standardize invocation (use either `membrane` or `npx @membranehq/cli@latest` consistently) and note that CONNECTION_ID, <actionId>, and <agentType> are placeholders the model must substitute.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient commands and tables, but the intro ('Uberduck is a text-to-speech platform...') and chatty lines like 'so you can focus on the integration logic rather than auth plumbing' add explanation that could be trimmed, fitting 'Mostly efficient but includes some unnecessary explanation.' | 3 / 5 |
Actionability | It provides concrete, copy-paste commands (install, login, connection ensure, action list/run, request) plus a thorough proxy flag table, but placeholders like CONNECTION_ID and <actionId> plus an npx-vs-membrane inconsistency leave minor gaps, fitting 'Mostly executable guidance; concrete code or commands with minor gaps.' | 4 / 5 |
Workflow Clarity | The connect→poll→handle-state flow has a real feedback loop (CLIENT_ACTION_REQUIRED → user acts → re-poll) and explicit state checks, but the dangling 'skip to Step 2' / '1b' references with no labeled Step 2 are a minor clarity gap, fitting 'Clear sequence with most checkpoints present; minor validation gaps.' | 4 / 5 |
Progressive Disclosure | With no bundle files, the single SKILL.md is organized into clear sections (Overview, Authentication, Connecting, Searching, Actions, Proxy, Best practices); the detailed clientAction schema and proxy flag table could arguably live in separate references, fitting 'Good structure; most content appropriately placed; minor organization gaps.' | 4 / 5 |
Total | 15 / 20 Passed |