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.
The body is a well-structured, actionable guide with executable commands, a flags table, and explicit connection-state checkpoints. Its main weakness is mild verbosity from background explanation and minor gaps in placeholders and file-splitting.
Suggestions
Trim background prose ('Datawrapper is an online platform...') and motivational phrases that Claude can infer, to improve token efficiency.
Make placeholder substitution explicit (e.g. show how to capture a CONNECTION_ID from the ensure step and reuse it in subsequent commands).
Consider splitting the proxy-request reference into a separate ADVANCED.md or REFERENCE.md and linking to it from the body to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean executable commands, but background prose like 'Datawrapper is an online platform... used by journalists' and 'so you can focus on the integration logic rather than auth plumbing' explains concepts Claude already knows, fitting 'mostly efficient but includes some unnecessary explanation'; it does not reach the trim level of score 4. | 3 / 5 |
Actionability | It provides concrete, executable commands throughout (install, login, connection ensure, action list, action run) plus a full proxy flags table, covering common cases copy-paste ready; minor gaps like unresolved CONNECTION_ID placeholders keep it just below 5. | 4 / 5 |
Workflow Clarity | The install → auth → connect → search → run sequence is clear, and connection-state polling (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) includes explicit checkpoints and a poll-again feedback loop; it falls short of 5 only because some retry/error-recovery detail is implicit. | 4 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is organized into clear sections (Overview, Working with Datawrapper, Popular actions, Best practices) with good navigation; minor organization gaps (e.g. the proxy reference could be a separate advanced file) keep it at 4 rather than 5. | 4 / 5 |
Total | 15 / 20 Passed |