CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastly-cli

Executes Fastly CLI commands for managing CDN services, Compute deploys, and edge infrastructure. Use when running `fastly` CLI commands, creating or managing Fastly services from the terminal, deploying Fastly Compute applications, managing backends/domains/VCL snippets via command line, purging cache, configuring log streaming, setting up TLS certificates, managing KV/config/secret stores, checking service stats, authenticating with Fastly SSO, or working with fastly.toml. Also applies when working with Fastly service IDs in CLI context, or with `fastly service`, `fastly compute`, `fastly auth`, or any Fastly CLI subcommand. Covers service CRUD, version management, autocloning, and troubleshooting common CLI errors.

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.

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.

DimensionReasoningScore

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

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.

The description is a model example: third-person voice, a precise capability inventory, and two explicit 'Use when' trigger clauses covering natural phrasings, synonyms, and exact subcommand names. It is both comprehensive and free of fluff or over-claims.

DimensionReasoningScore

Specificity

Lists many concrete actions — 'managing CDN services, Compute deploys', 'managing backends/domains/VCL snippets', 'purging cache', 'configuring log streaming', 'setting up TLS certificates', 'managing KV/config/secret stores', 'authenticating with Fastly SSO', 'working with fastly.toml', plus 'service CRUD, version management, autocloning, and troubleshooting common CLI errors'. Coverage is comprehensive across the CLI's surface; not below 4 because there are no meaningful gaps in the action list.

5 / 5

Completeness

Explicitly answers both: what ('Executes Fastly CLI commands for managing CDN services, Compute deploys, and edge infrastructure') and when ('Use when running `fastly` CLI commands, creating or managing Fastly services from the terminal, ...'), followed by a second explicit trigger clause ('Also applies when working with Fastly service IDs in CLI context...'). This mirrors the anchor-5 example structure of what + 'Use when' with concrete triggers.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered with synonyms and specifics: 'running `fastly` CLI commands', 'from the terminal', 'via command line', 'deploying Fastly Compute applications', 'purging cache', 'fastly.toml', 'Fastly service IDs', and exact subcommand names ('`fastly service`, `fastly compute`, `fastly auth`, or any Fastly CLI subcommand'). Matches the anchor's 'synonyms and file extensions' bar; score 4 would require noticeably missing natural terms, which is not the case.

5 / 5

Distinctiveness Conflict Risk

A clear niche — the Fastly CLI — with distinct triggers (`fastly` binary, fastly.toml, named subcommands, 'in CLI context'). It explicitly scopes stats and service-ID work to the CLI context, minimizing collision with adjacent Fastly skills; no generic language that would fire for unrelated skills.

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-cli/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.