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 delivers executable Membrane CLI commands and a clear connection state-machine workflow with polling and feedback, scoring well on actionability and workflow clarity. It is held back by an unnecessary marketing intro and some minor organizational and conciseness issues.
Suggestions
Remove the opening marketing paragraph about what Hume AI is; Claude already knows this and it adds tokens without guidance.
Fix the step numbering inconsistency (references to 'Step 2' and '1b' without a '1a'/'1') so the connection workflow reads as one coherent sequence.
Trim the duplicated 'membrane action list' invocation (it appears in both 'Searching for actions' and 'Popular actions') to a single canonical example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is efficient CLI commands and tables, but it opens with marketing prose ('Hume AI provides tools for understanding human behavior...') and repeats the action-list invocation, fitting the anchor for mostly efficient content with some unnecessary explanation that could be tightened. | 3 / 5 |
Actionability | It provides copy-paste bash commands for login, connection ensure, polling, action list/run, and proxy requests with flags explained, matching the anchor for mostly executable guidance with minor gaps (no concrete example actionId or sample output). | 4 / 5 |
Workflow Clarity | The connection flow has an explicit state machine (READY/BUILDING/CLIENT_ACTION_REQUIRED) with a poll loop and feedback to re-poll after user action, fitting the clear-sequence anchor; minor gaps come from inconsistent step numbering ('Step 2', '1b') rather than validation. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-sectioned with clear headers and no nested references (no bundle files exist), matching the good-structure anchor; it is a longer single file with some inline reference-style content (the proxy flags table) that keeps it just below the ideal split. | 4 / 5 |
Total | 15 / 20 Passed |