Content
88%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 tight, executable integration guide with concrete commands, a well-sequenced connection workflow, and explicit state-based validation and feedback loops. The only real slack is a little introductory background padding and minor redundancy in the actions section.
Suggestions
Trim the opening background paragraph ("Simvoly is a website builder platform...") and the auth-plumbing aside; Claude does not need the platform explained.
De-duplicate the "Popular actions" section, which restates the `action list --intent=QUERY` command already shown under "Searching for actions".
Add a one-line verification hint after `action run` (e.g., check the `output` field for errors / expected fields) to strengthen the run step's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, executable commands, but the opening "Simvoly is a website builder platform..." paragraph and phrases like "so you can focus on the integration logic rather than auth plumbing" are minor over-explanation Claude does not need; efficient overall with a little trimmable padding, matching the 4 anchor. | 4 / 5 |
Actionability | Copy-paste-ready commands cover the common cases end-to-end (npm install, membrane login, connection ensure, action list/run with --input, request proxy with a full flag table), matching the fully-executable anchor; placeholders like CONNECTION_ID and QUERY are explicitly parameterized rather than pseudocode. | 5 / 5 |
Workflow Clarity | The connect flow has an explicit sequence with validation checkpoints (poll --wait until state leaves BUILDING) and feedback loops (re-poll after the user completes a client action), plus error-state handling (CONFIGURATION_ERROR / SETUP_FAILED -> check the error field), matching the explicit-validation anchor. | 5 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized with a clear section hierarchy and no monolithic wall of reference material, matching the good-structure anchor; not a 5 because there are no one-level-deep references to split out (fine for scope) and the "Popular actions" section repeats the earlier search command, a minor redundancy. | 4 / 5 |
Total | 18 / 20 Passed |