Content
76%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 highly actionable with copy-paste CLI commands and a strong connection workflow, and it is reasonably concise with clear section structure. The main weakness is the lack of validation/verification steps around the destructive and create/update/delete actions the skill exposes, which caps workflow clarity.
Suggestions
Add an explicit validation/verification step before destructive action runs, e.g. list and confirm the target (get-draft-invoice) before running delete-draft-invoice, and check the response error field after the call.
Introduce a feedback loop for action execution (run -> inspect output/error -> retry or report), especially for create/update/delete operations on invoices, customers, suppliers, and products.
Trim the opening explanatory paragraph about what E-conomic is, since it restates context Claude can infer, to push conciseness toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean executable commands, tables, and flags, but the opening "E-conomic is an online accounting software primarily used by small to medium-sized businesses..." is minor over-explanation of context Claude can infer, matching anchor 4. It is above 3 because the bulk is efficient and below 5 due to that padded intro and a few explanatory asides. | 4 / 5 |
Actionability | It provides fully executable, copy-paste-ready commands with flags and JSON input examples covering the common cases (login, connection ensure/wait, action list, action run with --input, request proxy), matching anchor 5. It is not 4 because the guidance is concrete and complete rather than having minor gaps. | 5 / 5 |
Workflow Clarity | The connection setup is a well-sequenced flow with checkpoints (poll --wait until READY, handle CLIENT_ACTION_REQUIRED, re-poll), but the skill exposes destructive actions (delete-draft-invoice, create/update/delete on customers/invoices/products) with no validation or verification step before running them, so the destructive-operations cap holds at 3. It is not 4 because that validation gap is explicit in the rubric and takes precedence. | 3 / 5 |
Progressive Disclosure | No bundle files exist, and the body is one self-contained SKILL.md with well-organized section headers (Install, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices), matching anchor 4. It is below 5 because the sizable inline Popular-actions table and proxy-flag table are reference-like content that could be split out, and above 3 because structure is otherwise clear and navigable. | 4 / 5 |
Total | 16 / 20 Passed |