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 content is action-oriented with executable Membrane CLI commands and a connection-readiness polling loop, but it carries some unnecessary background explanation, an inconsistent CLI invocation form, and a dangling "Step 2" reference. Tightening the intro and fixing the step numbering would raise it further.
Suggestions
Trim the opening overview paragraph and Membrane auth rationale to the minimum needed for action; assume Claude knows general auth concepts.
Pick one invocation form (membrane vs npx @membranehq/cli) and use it consistently, or state the alias explicitly once.
Replace the undefined "skip to Step 2" reference with a concrete section anchor or numbered step so the workflow sequence is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but the intro explains what Kern AI is and Membrane's auth role in language Claude can infer, and the proxy prose could be trimmed, matching the mostly-efficient-but-could-be-tightened anchor. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready CLI commands and a flag table, but invocation is inconsistent ("membrane" vs "npx @membranehq/cli") and placeholders like CONNECTION_ID are left to the reader, matching mostly-executable with minor gaps. | 4 / 5 |
Workflow Clarity | The install-authenticate-connect-search-run sequence is clear with a state-polling feedback loop (READY/BUILDING/CLIENT_ACTION_REQUIRED), but "skip to Step 2" references a Step 2 that is never labelled, leaving a minor sequencing gap. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clearly headed sections with no external references needed for this CLI-usage skill, but the thin "Popular actions" section is underdeveloped, leaving minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |