Content
93%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.
A well-structured body: executable examples, complete input/output contracts, disciplined operating rules, and a clean two-script bundle. The only gap is the absence of explicit error-recovery guidance (e.g. retrying transient network errors or adjusting timeout_sec), which keeps workflow clarity just below perfect.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean bullet-style rules with no explanation of concepts Claude already knows (no GraphQL/JSON/pagination tutorials) and every section (operating rules, input, output, execution) carries operational value. The near-empty References section is the only marginal content, which is not enough to drop from anchor 5 to anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Two copy-paste-ready executable bash examples with real JSON payloads (a smoke-test query and a full heatmap invocation), complete input field documentation (query, query_path, variables, max_items, max_depth, timeout_sec, save_raw, raw_output_path), and enumerated output/error codes (invalid_json, invalid_input, network_error, invalid_response, graphql_error). The examples cover the common cases, matching anchor 5; anchor 4 would require missing key details, and the optional fields are all named explicitly. | 5 / 5 |
Workflow Clarity | Clear decision rules for which script handles which task, output-mode guidance (concise markdown vs verbatim JSON), a pre-flight checkpoint ("inspect the GraphQL row type first before adding candidate fields"), and a re-run rule for stale results. Not 5: there is no retry/error-recovery guidance for transient failures (e.g. what to do on network_error or timeout_sec behavior), so validation checkpoints are mostly but not fully present — anchor 4. Not 3: the sequence and checkpoints are explicit, and the destructive/batch cap does not apply since these are read-only API calls. | 4 / 5 |
Progressive Disclosure | Implementation appropriately lives in the two bundled scripts (both real and matching the documented interfaces), referenced one level deep from well-organized sections, with an explicit statement that no additional references are required. Content is correctly split — interface documentation in SKILL.md, execution in scripts/ — matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |