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 to driving Lusha through the Membrane CLI, with concrete commands, a clear connect-and-poll workflow, and error-state handling. Its main weakness is mild verbosity (marketing overview and a few padded explanations) and a large inline action-reference table that could be split out.
Suggestions
Trim the marketing-style Lusha overview paragraph and padded rationales ('burn less tokens', 'rather than auth plumbing') to keep only what Claude cannot infer.
Move the 13-row Popular actions table into a separate reference file (e.g. references/actions.md) and keep only the 3-4 most common actions inline, signaling the rest with a one-level-deep link.
Add an explicit validation/verification checkpoint after running actions (e.g., check the response `output` field and handle empty results or error states) to strengthen the workflow's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable commands and tables, but includes unnecessary explanatory prose ('so you can focus on the integration logic rather than auth plumbing', 'This will burn less tokens and make communication more secure') and a marketing-style Lusha overview that could be trimmed, matching the 'mostly efficient but includes some unnecessary explanation' anchor. | 3 / 5 |
Actionability | Concrete executable commands appear throughout (npm install, membrane login, connection ensure, action run/list, request) with flag tables and JSON examples, matching 'mostly executable guidance with minor gaps' since some placeholders (CONNECTION_ID, <actionId>) and output-handling detail are lightly specified. | 4 / 5 |
Workflow Clarity | A clear sequence (install -> authenticate -> connect -> search -> run/proxy) with an explicit feedback loop ('After the user completes the action... poll again to check if state moved to READY') and error-state branching matches 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is well-organized with clear section headers and a popular-actions table. The simple-skill note allows a high score, but a sizeable inline actions reference that could be a separate file keeps it at 'good structure with minor organization gaps' rather than 5. | 4 / 5 |
Total | 15 / 20 Passed |