Content
75%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 guide to driving Terra via the Membrane CLI, with a clear sequenced workflow and explicit connection-state validation. It is held back from top marks only by minor over-explanation, a command-form inconsistency, and slightly irregular step numbering.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command/table-driven with sectioned structure, containing only minor over-explanation (e.g. "so you can focus on the integration logic rather than auth plumbing" and the opening background sentence) that could be trimmed, fitting the 'efficient; minor instances of over-explanation' anchor. | 4 / 5 |
Actionability | It provides concrete, copy-paste-ready commands for install, login, connection ensure, action list/run, and request plus a flags table, with only minor gaps such as the inconsistent `membrane` vs `npx @membranehq/cli` invocation form and placeholder substitution, placing it just below the fully-comprehensive level 5. | 4 / 5 |
Workflow Clarity | The install→auth→connect→search→run sequence has explicit state-based validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and feedback loops (poll again after the user acts), but the numbering is slightly irregular (a "1b" with no clear "1a", an unlabeled "Step 2"), keeping it below a 5. | 4 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is well-organized into clearly headed sections; however some inlined reference detail (the proxy flags table and the clientAction field breakdown) could live in separate files, fitting 'good structure; minor organization gaps' rather than the ideal one-level-deep split of a 5. | 4 / 5 |
Total | 16 / 20 Passed |