CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastly

Configures, manages, and debugs the Fastly CDN platform — covering service and backend setup, caching and VCL, security features like DDoS/WAF/NGWAF/rate limiting/bot management, TLS certificates and cache purging, the Compute platform, and the REST API. Use when working with Fastly services or domains, setting up edge caching or origin shielding, configuring security features, making Fastly API calls, enabling products, or looking up Fastly documentation. Also applies when troubleshooting 503 errors or SSL/TLS certificate mismatches on Fastly, and for configuring logging endpoints, load balancing, ACLs, or edge dictionaries. Read the relevant reference file before writing any Fastly API call or curl command — request field names (e.g. the backend fields override_host, ssl_cert_hostname, ssl_sni_hostname, use_ssl) are easy to misremember, and a wrong name causes a silent 503 instead of an error, so do not rely on training-knowledge field names.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An excellent description: comprehensive concrete capabilities, explicit and varied "use when" triggers including specific failure modes (503s, cert mismatches), all in third person within a reasonable length. The final sentence about backend field names is behavioral guidance rather than capability description and adds length, but it reinforces a genuine trigger (before writing Fastly API calls) rather than padding.

DimensionReasoningScore

Specificity

Uses concrete third-person verbs ("Configures, manages, and debugs") and enumerates specific capability areas: "service and backend setup, caching and VCL, security features like DDoS/WAF/NGWAF/rate limiting/bot management, TLS certificates and cache purging, the Compute platform, and the REST API". Coverage spans the platform surface comprehensively rather than with minor gaps, so it fits the 5 anchor rather than 4.

5 / 5

Completeness

Explicitly answers both questions: the "what" is the opening capability sentence, and the "when" is stated twice with concrete triggers ("Use when working with Fastly services or domains..." and "Also applies when troubleshooting 503 errors..."). Both are explicit and concrete, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensive: "working with Fastly services or domains", "setting up edge caching or origin shielding", "making Fastly API calls", "enabling products", plus concrete failure-mode triggers like "troubleshooting 503 errors or SSL/TLS certificate mismatches on Fastly" and "configuring logging endpoints, load balancing, ACLs, or edge dictionaries". Includes synonyms and error-level terms users would actually say, matching the 5 anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche anchored to a named platform throughout — "Fastly CDN platform", "NGWAF", "the Compute platform", "edge dictionaries" — with generic terms (rate limiting, TLS) always tied to Fastly context. Trigger phrases are vendor-specific enough that conflict with other CDN/security skills is minimal.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fastly/fastly-agent-toolkit

Path

skills/fastly/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.