Content
63%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 solid, command-driven CLI guide with genuinely good connection-lifecycle handling (polling, client actions, error states) and executable commands at every step. Its weaknesses are structural and editorial: an unnecessary platform introduction, a redundant "Popular actions" section that lists no actions, and broken internal references ("Step 2", "1b") that leave the workflow numbering incoherent. Tightening the prose and repairing the section structure would move it from adequate to strong.
Suggestions
Fix the internal navigation: replace the dangling "skip to **Step 2**" references and the orphan "#### 1b" heading with a consistently numbered step sequence (install → login → connect → discover → run).
Delete the redundant "Popular actions" section or populate it with actual common action examples, and remove the 3dcart platform introduction plus "Use action names and parameters as needed" filler.
Add a brief validation note for mutating action runs (e.g., check the response error/output fields, or run a read action to confirm the connection works) before relying on results.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient command-focused prose, but it includes unnecessary material: the opening paragraph explaining what 3dcart is ("3dcart is an e-commerce platform that provides businesses with the tools to build and manage online stores..."), the filler line "Use action names and parameters as needed," and duplicated action-discovery instructions in both "Searching for actions" and "Popular actions." It is not a 2 because the bulk is concrete commands rather than padded explanation, and not a 4 because several sections could clearly be trimmed. | 3 / 5 |
Actionability | Concrete, executable bash commands throughout (npm install, membrane login, connection ensure, action list/run with --input JSON, proxy flags table). Minor gaps keep it from a 5: CONNECTION_ID placeholders are never tied to where they come from, the "Popular actions" section promises popular actions but only repeats the discovery command instead of showing any real ones, and two "skip to **Step 2**" references point to a section that does not exist. Well above a 3 since everything shown is copy-paste ready. | 4 / 5 |
Workflow Clarity | The sequence is clear and state-aware: install → login (with headless fallback and code completion) → connection ensure → poll with --wait, then explicit per-state handling (READY, CLIENT_ACTION_REQUIRED with clientAction fields, CONFIGURATION_ERROR/SETUP_FAILED) and a re-poll feedback loop. It misses a 5 because there are no validation steps around running mutating actions and the dangling "Step 2" reference and orphan "1b" numbering break the numbered structure; it stays above 3 because the connection-lifecycle checkpoints and error-recovery loop are explicit. | 4 / 5 |
Progressive Disclosure | There are no bundle files, so everything lives inline in a ~145-line SKILL.md with usable section headers. Structure is present but uneven: the "Popular actions" section duplicates "Searching for actions" instead of listing actions, "1b" appears without a "1a" or numbered steps, and "Step 2" is referenced but undefined, making navigation genuinely confusing. Not a 2 — headers, a table, and code blocks keep it navigable — but the disorganization and redundancy fall short of a 4. | 3 / 5 |
Total | 14 / 20 Passed |