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.

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 high-quality CLI skill body: copy-paste-ready commands with correct/wrong contrasts, a fully checkpointed new-service workflow with error-recovery loops, and exemplary one-level progressive disclosure to a well-organized references table. The only weakness is mild redundancy — the 'Trigger and scope' opener duplicates the frontmatter description, and the Troubleshooting section recapitulates pointers already given inline.

Suggestions

Trim or remove the 'Trigger and scope' section at the top of the body — its coverage list and critical path-note duplicate the frontmatter description and the Troubleshooting section; keep at most the one-line unintuitive-path warning.

Cut the Troubleshooting recap's cross-references to inline sections ('see Host Header Override Pattern', 'see Common Flag Examples') and let the direct link to troubleshooting.md stand alone.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, high-value gotchas (bare boolean flags, 'fastly domain create' 403 path, '--version active', KV eventual consistency, SHIELD vs CODE column) and assumes Claude's competence throughout. However, the opening 'Trigger and scope' section re-states coverage the frontmatter description already declares, and the Troubleshooting section recap re-points to sections already covered inline, so a few tokens could be trimmed — anchor 4 ('minor instances of over-explanation that could be trimmed') fits better than 5.

4 / 5

Actionability

Fully executable, copy-paste-ready bash for the common cases (autoclone backend/domain creation, stats historical/realtime, full pre-flight curl/openssl checks) plus explicit CORRECT/WRONG flag contrasts. This matches anchor 5 ('copy-paste ready code or commands; specific examples cover the common cases'); anchor 4's 'minor gaps' is not in evidence.

5 / 5

Workflow Clarity

The New VCL Service Setup Workflow is a clearly numbered sequence with explicit validation checkpoints (pre-flight origin/cert check, 'validate version before activating', post-activation curl verification) and feedback loops for error recovery ('If 500 Domain Not Found, wait and retry... If 503, check backend SSL settings'), plus propagation-delay retry guidance. This matches anchor 5; it is not anchor 4 because checkpoints and error-recovery loops are both present and explicit.

5 / 5

Progressive Disclosure

The body is a genuine overview that keeps only high-frequency gotchas inline and delegates bulk detail via a references table with 'Use when...' guidance pointing to nine real, one-level-deep files (all verified to exist in references/). Matches anchor 5 ('clear overview with well-signaled one-level-deep references'); there is no inlining of content that belongs in a separate file.

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 exemplary description: concrete capabilities, an explicit and richly specific 'Use when...' trigger clause, product-specific terms that eliminate conflict risk, and third-person voice throughout. Its only cost is length, but every clause carries a distinct capability or trigger rather than padding.

DimensionReasoningScore

Specificity

The description lists many concrete, specific actions ('purging cache, configuring log streaming, setting up TLS certificates, managing KV/config/secret stores, checking service stats, authenticating with Fastly SSO') with comprehensive coverage of the CLI's surface, in third-person voice. It matches the score-5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and exceeds anchor 4, which expects only 'several specific actions with minor gaps'.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Executes Fastly CLI commands for managing CDN services, Compute deploys, and edge infrastructure') and an explicit 'Use when...' clause enumerating concrete trigger scenarios. This mirrors the score-5 reference example structure; anchor 4 ('when could be more explicit or specific') does not fit since the when-clause is highly specific.

5 / 5

Trigger Term Quality

It combines natural user phrasing ('running fastly CLI commands', 'purging cache', 'deploying Fastly Compute applications', 'working with fastly.toml') with literal command triggers ('fastly service', 'fastly compute', 'fastly auth', or any Fastly CLI subcommand'). This is comprehensive natural-term coverage including synonyms and exact CLI tokens, matching anchor 5 rather than anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche: everything is Fastly-specific (fastly.toml, Fastly SSO, Fastly service IDs, autocloning, named subcommands), so it is unlikely to trigger for a non-Fastly skill. Minimal conflict risk matches anchor 5; anchor 4 ('minor overlap risk with closely related skills') would require some ambiguity that is not present.

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.