Content
92%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.
An excellent CLI skill body: every section carries non-obvious operational knowledge, commands are copy-paste executable with correct/wrong contrasts, and the new-service workflow includes genuine validation checkpoints and error-recovery loops. The only weakness is mild redundancy between the Key Patterns, Global Flags, and Common Flag Examples sections, plus example commands repeated across sections.
Suggestions
Remove duplicated guidance from 'Key Patterns' (version-targeting flags and the 'logging is under service logging' note already appear in 'Global Flags' and the opening CRITICAL line) — a single authoritative location would trim tokens without losing coverage.
Consolidate the repeated `fastly service domain create` / `fastly service backend create` examples: keep the correct/wrong flag contrasts in 'Common Flag Examples' and reference them from the workflow instead of re-printing full commands in both places.
Consider moving the KV Store Gotchas detail (25 MB entry limit, listing semantics) into references/stores.md, keeping only the link-before-use gotcha inline since it blocks first-time use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, CLI-specific gotchas (unintuitive command paths, boolean-flag behavior, propagation delays, KV eventual consistency) and assumes Claude's competence — no padding explaining what a CDN or TLS is. It falls short of 5 due to redundancy: version-targeting flags are listed in both 'Global Flags' and 'Key Patterns', the 'Logging is under `service logging`' note duplicates the opening CRITICAL line, and `fastly service domain/backend create` examples appear in both 'Common Flag Examples' and the new-service workflow. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: correct/wrong flag contrasts ('CORRECT - boolean flags are bare, no value' vs the WRONG variant), complete backend create invocations with all four TLS flags, jq fallback selectors ('.ActiveVersion.Number // .ActiveVersion'), and curl/openssl pre-flight checks. Specific examples cover the common cases and the highest-confusion flags. | 5 / 5 |
Workflow Clarity | The 'New VCL Service Setup Workflow' is a 6-step sequence with an explicit validation checkpoint at nearly every step — TLS SAN pre-flight check, `fastly service version validate` before activation, and post-activation verification with error-recovery guidance ('If 500 "Domain Not Found", wait and retry... If 503, check backend SSL settings'). This matches the anchor's validate -> fix -> retry feedback-loop pattern; no gaps to justify 4. | 5 / 5 |
Progressive Disclosure | A clear overview structure with a well-signaled references table of 10 one-level-deep files (all verified to exist), each with a 'Use when...' column for discovery, plus a dedicated troubleshooting.md link. Content is appropriately split: command structure, top pitfalls, and one worked workflow inline; provider-specific detail (25+ logging providers, NGWAF workspaces, TLS subscriptions) lives in the reference files. Below-5 would require buried references or inline content that belongs in the bundle, neither of which applies. | 5 / 5 |
Total | 19 / 20 Passed |