Agent skill · Grafana Labs

k6 Load Testing skill for Claude Code, Codex and Cursor

Writes and reviews k6 scripts for load, stress, soak and browser tests.

Officialname: k6★ 290 (repo)pushed 2026-10-24Apache-2.0SKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Generate, validate, and review k6 test scripts — load, stress, spike, soak, smoke, breakpoint, functional, and protocol. Covers HTTP, WebSocket, gRPC, browser, all executors, thresholds, checks, custom metrics, the k6-testing library, k6 Cloud execution, and the xk6 extension ecosystem; uses the xk6-docs CLI (with grafana.com web fallback) for docs lookup and validates every script by running it.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install k6 Load Testing

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add grafana/skills --skill k6

This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (grafana-core, grafana-cloud, grafana-lgtm, grafana-plugins...), or copy only this skill into ~/.claude/skills. docs

/plugin marketplace add grafana/skills
/plugin install <plugin>@grafana-skills

# or only this skill:
npx skills add grafana/skills --skill k6 -a claude-code

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/grafana/skills.git /tmp/k6-src
cp -r /tmp/k6-src/skills/grafana-k6/k6 ./k6
zip -r k6.zip k6

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add grafana/skills --skill k6 -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install grafana/skills k6

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add grafana/skills --skill k6 -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/grafana/skills.git --path skills/grafana-k6/k6

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add grafana/skills --skill k6 -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add grafana/skills --skill k6 -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

Bundles 18 JavaScript scripts the agent can run, so it needs JavaScript on the machine. In the Claude apps, code execution must be on.

What's in the SKILL.md

11 sections

Step 1: Pick the right example file
Step 2: Adapt the example
Step 3: Fill gaps with docs (only if needed)
Step 4: Save
Step 5: Validate
Step 6: Best-practices review
General checks (all scripts)
Load & breakpoint tests
Browser scripts — recommended practices
Step 7: Present results
Step 8: Execute

Bundled files

SETUP.md
browser-best-practices.md
docs-guidance.md
examples/browser.js
examples/cloud.js
examples/crypto-encoding.js
examples/executors.js
examples/ext-crawler.js
examples/ext-dns.js
examples/ext-exec.js
examples/ext-faker.js
examples/ext-redis.js
examples/ext-sql.js
examples/ext-tcp.js
examples/ext-tls.js
examples/functional.js
examples/grpc.js
examples/html.js
examples/http.js
examples/metrics.js
+ 1 more

Loaded only when the instructions point to them.

Facts

Skill name: k6
Publisher: Grafana Labs (official)
Repo: grafana/skills
License: Apache-2.0
SKILL.md size: 1,669 words, 188 lines
Bundled files: 21, 18 scripts (JavaScript), 3 docs
Repo stars: 290 (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Grafana MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from grafana/skills

PromQL: Writes, checks and speeds up PromQL queries for Prometheus and Grafana metrics.

Related testing & qa skills

Web App Testing · Anthropic
Agent Browser · Vercel
Playwright Browser Automation · OpenAI
Playwright CLI · Microsoft (Playwright)
Property-Based Testing · Trail of Bits
Analyze .NET Performance · Microsoft (.NET)
Browserbase Browser · Browserbase
Adversarial UI Test · Browserbase

FAQ

What does the k6 skill do?+

Writes and reviews k6 scripts for load, stress, soak and browser tests. In its own SKILL.md, Grafana Labs describes it as: "Generate, validate, and review k6 test scripts — load, stress, spike, soak, smoke, breakpoint, functional, and protocol."

How do I install the k6 skill?+

Run npx skills add grafana/skills --skill k6 and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/k6/SKILL.md; in Codex and Cursor in .agents/skills/k6/.

Does k6 Load Testing work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains k6 Load Testing?+

Grafana Labs, the company or project behind it, in the grafana/skills repo on GitHub, last pushed 2026-10-24. License: Apache-2.0.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers