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.
A well-crafted overview skill: token-efficient gotcha-focused content, a validation-first quick start with error-recovery guidance, and exemplary one-level-deep reference routing with deliberate boundary statements. The single notable weakness is the VCL table recipe, whose inline table declaration is not valid uploaded VCL on a real service without the API-based dictionary creation steps documented in vcl-services.md.
Suggestions
In the 'VCL Table for Lookups' recipe, note that tables/edge dictionaries must be created via the API or CLI (see vcl-services.md 'Edge Dictionaries') — the inline `table` declaration is not uploadable custom VCL on a real service, only a Fiddle-style illustration.
Add the concrete table-creation/item steps (e.g. POST /service/{id}/version/{v}/dictionary and .../item, or the equivalent fastly CLI commands) so the table recipe is runnable end to end.
Briefly signal at the top that this skill depends on companion skills (fastly-cli for the full create/activate workflow, fastly-stats for traffic numbers) so the Quick Start pointer remains resolvable context even when reading the body alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense with non-obvious knowledge: no concept explanations (nothing teaches what a CDN or VCL is), and sections are pure gotchas ("obj.ttl is only meaningful in vcl_hit", "beresp.* is only available in vcl_fetch", "req.request is deprecated — use req.method"), commands, or navigation. Every line carries information Claude would not reliably know from training. | 5 / 5 |
Actionability | Mostly copy-paste ready: five complete executable VCL recipes, concrete pre-flight commands (curl with Host header, openssl s_client SAN check), and a precise common-mistakes list. Minor gap: the "VCL Table for Lookups" recipe presents an inline `table redirects { ... }` declaration as if it were uploadable VCL, but on a real service tables/edge dictionaries must be created via the API (as vcl-services.md's "Edge Dictionaries" endpoints document), and the recipe doesn't say so — matching the 4 anchor (concrete code with minor gaps) rather than 5. | 4 / 5 |
Workflow Clarity | The Quick Start is a genuine pre-flight checklist with numbered validation steps and executable checks ("Verify the origin responds", "Check TLS certificate SANs"), an explicit error-recovery branch ("If HTTPS cert validation cannot be made correct but HTTP with the intended Host works, use an HTTP backend or fix the origin cert; never disable backend cert verification"), and a precise pointer to the full create-service workflow. This matches the 5 anchor: clear sequence, explicit validation, feedback loop. | 5 / 5 |
Progressive Disclosure | Model structure: a 21-row Topics table where every row links a real (verified present) one-level-deep reference file with a per-topic "Use when..." routing column, an explicit boundary statement routing stats topics to the separate fastly-stats skill, and inline content limited to the highest-frequency gotchas. Navigation is easy and the split is appropriate, matching the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |