Content
100%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.
This is a dense, high-signal operating manual: non-obvious API gotchas are stated as falsifiable rules, every worked example is executable and correct-by-construction against those rules, and detail is appropriately pushed to three well-labeled reference files. It trusts the reader's competence throughout and spends every token on Fastly-specific behavior that could not be inferred.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains no explanation of concepts Claude already knows (no preamble on what Fastly, caching, jq, or curl are) — every sentence carries Fastly-specific lore Claude cannot know, such as "a relative window opens and closes mid-bucket, so `--from "N days ago" --by day` returns N-1 buckets" and "`ts/h` on `rt.fastly.com` covers the last 120 seconds, not an hour". The example dates (2026-07-01T00:00:00Z) demonstrate the exact UTC-boundary format rule 2 depends on rather than encoding time-sensitive instructions, so they do not trigger the date penalty. This is the lean, competence-assuming 5 anchor, not the 4 anchor with trimmable over-explanation. | 5 / 5 |
Actionability | Five complete, copy-paste-ready bash pipelines with jq cover the common cases (monthly hit ratio recomputed from counters, 5xx share correct on both service types, per-service bandwidth ranking driven from the service list, account usage totals, and a wall-clock-bounded live RPS sample), plus a command-selection table and a concrete curl example with the auth header. This matches the 5 anchor (fully executable, examples cover common cases) rather than the 4 anchor with minor gaps. | 5 / 5 |
Workflow Clarity | The path from question to answer is unambiguous: pick the command from the table, apply the ten correctness rules, adapt a worked answer. Explicit validation checkpoints are present where they matter — "Read back `meta.from` / `meta.to`", "assert `meta` carries the filter you sent", "Check `fastly products -s ID` before concluding there is nothing to see" — and error recovery is delegated to references/debugging.md. Operations are read-only queries, so the destructive/batch validation cap does not apply, and under the simple-skill note the single action is unambiguous, fitting the 5 anchor over the 4. | 5 / 5 |
Progressive Disclosure | The body keeps only the operating core (rules, command table, worked answers, traps) and moves exhaustive detail to three verified one-level-deep references, each clearly signaled with its content: "Endpoint paths, parameters and response shapes: [references/api.md]", "Field names and aggregation shape: [references/fields.md]", "Errors, empty data and wrong-scope symptoms: [references/debugging.md]". All three files exist (203/178/192 lines) with content matching their labels, and no reference nests further references, matching the 5 anchor. The single external pointer to the `fastly-cli` skill's flag matrix is clearly labeled but does not create buried navigation. | 5 / 5 |
Total | 20 / 20 Passed |