fastly agent toolkit — Agent Skill

Fastly Agent Toolkit

A collection of skills for AI coding agents to work with the Fastly platform and edge computing tools.

• Fastly Agent Toolkit
• Agent Plugins
• Available skills
• Runtime requirements
• Support and privacy
• Usage
• Manual copy
• Claude Code
• Codex
• Perplexity
• Swival
• Qwen Code
• Gemini CLI
• Using the `skills` CLI
• Skill format
• Contributing new skills

Agent Plugins

This repository is a portable Agent Plugin. Clients load the root `plugin.json` manifest and discover the skills in skills/.

Available skills

• fastly: Working with the Fastly platform, including services, caching, VCL, WAF, TLS, DDoS protection, purging, and API usage.
• fastly-cli: Using the Fastly CLI to manage services, compute apps, logging, WAF, TLS, key-value stores, and stats.
• fastly-fiddle: Testing VCL against real Fastly edge infrastructure with Fastly Fiddle, covering assertion-based tests, the Fiddle HTTP API, shareable bug reproductions, and CI integration.
• fastly-stats: Fastly traffic numbers via the CLI or raw HTTP, covering the Historical Stats, Real-Time analytics, and Origin/Domain Inspector APIs, and owning the unit, window, and aggregation conventions that decide whether a reported figure is right.
• fastly-ngwaf: Auditing Next-Gen WAF workspaces for missing or disabled protection rules and checking whether attack traffic is being blocked.
• fastly-reference-architectures: Curated GitHub repositories demonstrating working reference architectures on Fastly, from single Compute applications to systems combining multiple Fastly products.
• falco: VCL development with Falco, covering linting, testing, simulation, formatting, REPL, and Terraform integration.
• fastlike: Running Fastly Compute locally with Fastlike, covering backend configuration, builds, and testing.
• viceroy: Running Fastly Compute locally with Viceroy, covering serving, configuration, testing, and SDK adaptation.
• xvcl: The XVCL VCL transpiler, covering syntax extensions, subroutines, header manipulation, and caching logic.

Each skill lives under skills/ with a SKILL.md entrypoint and a references/ directory containing detailed topic files.

Important: SKILL.md files reference companion files in their references/ directory. Make sure your agent is allowed to read from these directories, otherwise it won't be able to follow the references and will miss important context.

Runtime requirements

These skills are intended for coding environments that can read project files and run commands. Install the tools for the workflows you use; installing the plugin does not install its developer tools or connect a Fastly account.

<details> <summary>Workflow-specific requirements</summary>

| Workflow | Requirements | | ----------------------------------------- | ------------------------------------------------------------------------------------------ | | Fastly CLI and traffic statistics | Fastly CLI and locally configured authentication; curl and jq for raw API examples | | NGWAF assessment script | Bash, curl, jq, and a locally configured FASTLY_API_KEY with access to the workspace | | VCL linting, unit tests, and simulation | Falco; installation requires Homebrew or Go | | XVCL compilation | uv with uvx and access to the XVCL package; Falco for the local checks | | Local Compute development | Fastlike or Viceroy, plus the build tools and WASM targets required by the application | | Fastly Fiddle tests | Bash, curl 7.76 or newer, jq, and network access to Fastly Fiddle | | Documentation and reference architectures | A browser or HTTP client; Git when cloning examples or tool sources |

Each skill describes its prerequisites and installation options. Package installation and source builds may need network access. Bundled scripts and examples are resolved from the installed skill directory, while your project files stay relative to your project's working directory.