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.
A well-structured, actionable integration guide with concrete CLI commands and a validated connection workflow. Its main weakness is conciseness: an opening marketing-style description of Leadfeeder and minor padded phrasing consume tokens without adding guidance value.
Suggestions
Trim the opening paragraph ('Leadfeeder is a B2B sales and marketing tool...') to a single line or remove it; Claude does not need the marketing framing to use the CLI.
Tighten conversational filler such as 'so you can focus on the integration logic rather than auth plumbing' to pure instruction.
Consider moving the Popular actions table and proxy flag reference into a separate references/ file linked from the body, which would improve progressive disclosure and reduce the main file's token footprint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI documentation, but it opens with three sentences explaining what Leadfeeder is ('Leadfeeder is a B2B sales and marketing tool that identifies website visitors...') and includes minor padding like 'so you can focus on the integration logic rather than auth plumbing'. This matches anchor 3 (mostly efficient but includes some unnecessary explanation that could be tightened) rather than the leaner anchor 4. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands throughout ('npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.leadfeeder.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --json') plus a real actions table with keys. It sits at anchor 4 (mostly executable, concrete commands with minor gaps from placeholders like CONNECTION_ID and QUERY) rather than anchor 5, whose examples cover common cases without substitution. | 4 / 5 |
Workflow Clarity | The connection workflow is sequenced (install → login → connection ensure → poll for READY → search actions → run) with explicit state-based validation ('state: READY', 'CLIENT_ACTION_REQUIRED', 'CONFIGURATION_ERROR') and a feedback loop ('After the user completes the action... poll again'). This matches anchor 4 (clear sequence with most checkpoints present, minor gaps) rather than anchor 5, because step references are slightly inconsistent ('skip to Step 2', 'Step 1b' without a cleanly numbered step list). | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/scripts/assets are absent) and the skill is a single ~150-line file with clear section headers (Overview, Working with Leadfeeder, Popular actions, Best practices). Structure is good and content is appropriately placed inline, matching anchor 4; it does not reach anchor 5 because there are no one-level-deep reference links and the popular-actions/proxy-detail tables could arguably live in separate reference files. | 4 / 5 |
Total | 15 / 20 Passed |