Content
56%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 strong, executable Membrane CLI guidance with a well-sequenced connection workflow and helpful state-handling checkpoints. Its chief drawback is the bloated, partly-duplicated entity list that wastes tokens and the absence of any split-out reference material.
Suggestions
Remove or drastically trim the ~120-item entity list, including the duplicated "Report", "Integration", and "Forecast" entries; keep only entities the skill meaningfully acts on.
Move the full popular-actions table and entity catalog into a separate reference file (e.g. ACTIONS.md) referenced from the body, so SKILL.md stays a lean overview.
Tighten the intro paragraph that explains what JobNimbus is, since Claude can infer CRM basics, and reserve detail for Jobnimbus-specific behavior.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~120-item bulleted entity list ("Contact", "Job", "Estimate", ... "Web App") with duplicated entries ("Report", "Integration", "Forecast" each appear twice) is a large padded section that adds little actionable value, making the body noticeably verbose despite lean CLI instructions. | 2 / 5 |
Actionability | Concrete, copy-paste-ready commands appear throughout ("npm install -g @membranehq/cli@latest", "membrane connection ensure 'https://www.jobnimbus.com/' --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json"), with only minor gaps such as unfilled placeholders. | 4 / 5 |
Workflow Clarity | The install → authenticate → connect → search → run/proxy sequence is clear, with real checkpoints (poll until state is READY, handle CLIENT_ACTION_REQUIRED, inspect CONFIGURATION_ERROR/SETUP_FAILED), though it stops short of a fully explicit validate-fix-retry checklist. | 4 / 5 |
Progressive Disclosure | Section headers give reasonable structure, but with no bundle files present the large inlined entity list and full popular-actions table are content that would be better split into separate reference files, leaving organization only partly realized. | 3 / 5 |
Total | 13 / 20 Passed |