CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

falco

Lints, tests, simulates, and formats Fastly VCL code using the falco tool. Also serves as the authoritative VCL reference via the falco Go source, which implements Fastly's full VCL dialect. Use when validating VCL syntax, running VCL linting, testing VCL locally, simulating VCL request handling, formatting VCL files, writing VCL unit tests with assertions, debugging VCL logic errors, looking up VCL function signatures or variable scopes, understanding VCL subroutine behavior, or running `falco lint`/`falco simulate`/`falco test`/`falco fmt`. Also applies when working with VCL syntax errors, type mismatches in VCL, choosing which VCL subroutine to use, or setting up a local VCL development and testing environment.

72

Quality

90%

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

82%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-built reference skill: fully executable commands, real and clearly-navigable bundle files, and dense domain-specific gotchas with no fluff. The main improvement opportunities are deduplicating the two source-reference sections (one of which duplicates content already in understanding-vcl-from-source.md) and adding a brief lint→test→simulate workflow with failure handling.

Suggestions

Collapse the "Source Code as VCL Reference (Quick Lookup)" table into understanding-vcl-from-source.md — the body already links to it twice, and the table's file-path detail is reference material, not overview material.

Add a short ordered workflow (lint → test → simulate → only then deploy) with an explicit "if lint/test fails, fix and re-run" checkpoint to strengthen feedback loops.

Consider trimming the "Trigger and scope" section since it restates the frontmatter description almost verbatim.

DimensionReasoningScore

Conciseness

The body is dense with actionable material (command tables, flag tables, quick-reference snippets, a config block) with almost no padding or explanation of concepts Claude already knows. It misses a 5 because the "Source Code as VCL Reference (Quick Lookup)" table substantially overlaps the "Using Falco Source as VCL Reference" section — both point to the same understanding-vcl-from-source.md reference — and the "Trigger and scope" section repeats the frontmatter description, so a few sections could be trimmed or consolidated.

4 / 5

Actionability

Every section is copy-paste executable: install commands for three methods, an eight-command CLI table, a flags table, and ready-to-run invocations including `falco -vv -I ./vcl ./vcl/main.vcl`, the simulate flow with a verification `curl http://localhost:3124/path`, and a full `.falco.yaml` example. The common-issues section gives concrete wrong/right fixes (`set beresp.ttl = 86400` vs `86400s`).

5 / 5

Workflow Clarity

This is a tool-reference skill rather than a pipeline, and the quick-reference ordering (lint before deployment → run tests → simulate locally) plus per-task snippets gives an unambiguous path for each task, with lint acting as the validation step. It stops short of a 5 because there is no explicit sequence or feedback loop tying tasks together (e.g., a "lint → test → simulate → then deploy" progression with what to do on failure).

4 / 5

Progressive Disclosure

Eight reference files all exist in ./references/ and are surfaced through a well-signaled table with a "Use when..." column, one level deep — matching the 5 anchor's structure. It loses a point because the inline source-path lookup table (eight rows mapping questions to falco source directories) is detail that belongs inside understanding-vcl-from-source.md rather than duplicated in the main file, leaving the overview slightly heavier than ideal.

4 / 5

Total

17

/

20

Passed

Description

92%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.

A strong description: it states multiple concrete capabilities, doubles as a reference-guide trigger, and provides an explicit, granular "Use when" clause. The only gap is the absence of file-extension triggers (.vcl) and the bare phrase "VCL files" in the description itself.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "Lints, tests, simulates, and formats Fastly VCL code" — and adds a distinct second capability ("serves as the authoritative VCL reference via the falco Go source"), giving comprehensive coverage of what the tool does.

5 / 5

Completeness

Both halves are explicit: a clear "what" (lint, test, simulate, format, plus source-as-reference) followed by a concrete "Use when..." clause listing a dozen specific triggers, exactly matching the 5 anchor pattern.

5 / 5

Trigger Term Quality

Excellent natural trigger coverage ("validating VCL syntax", "testing VCL locally", "writing VCL unit tests", "debugging VCL logic errors", plus the literal `falco lint`/`falco simulate`/`falco test`/`falco fmt` commands). It falls just short of the 5 anchor because it omits file-extension triggers like `.vcl` and the plain phrase "VCL files", which the body's trigger section does cover but the description itself does not.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — Fastly VCL and the falco tool are named throughout, with command-specific triggers; no plausible confusion with generic linters or other Fastly surfaces (Compute/WASM, API/dashboard are explicitly excluded in the body).

5 / 5

Total

19

/

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