# k6-docs

k6-docs helps assistants write and debug Grafana k6 load tests using current documentation, API syntax, and stage configurations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install
- Author: takuan-osho
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/takuan-osho/ccmarketplace/tree/HEAD/plugins/k6-docs/skills/k6-docs/SKILL.md
- Updated: 2026-07-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/takuan-osho-k6-docs

## What it does

This skill instructs coding assistants on how to build Grafana k6 load tests correctly. It directs the model to online documentation sections covering the JavaScript API, execution lifecycles, checks, and threshold settings. It also provides reference patterns for common HTTP operations and multi-stage ramping profiles.

Documentation is not bundled locally. The skill guides the model to fetch live reference pages from `grafana.com` via web tools, meaning outbound internet access is required to look up parameters.

## Requirements
- Works with: Grafana

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add takuan-osho/ccmarketplace --skill k6-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/k6-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/k6-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add takuan-osho/ccmarketplace --skill k6-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/k6-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add takuan-osho/ccmarketplace --skill k6-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/k6-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install takuan-osho/ccmarketplace plugins/k6-docs/skills/k6-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/k6-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add takuan-osho/ccmarketplace --skill k6-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/takuan-osho/ccmarketplace --path plugins/k6-docs/skills/k6-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/k6-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add takuan-osho/ccmarketplace --skill k6-docs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/takuan-osho/ccmarketplace/tree/HEAD/plugins/k6-docs/skills/k6-docs/SKILL.md

## When to use it
- configure k6 threshold metrics and pass-fail rules
- build staged ramping load tests for HTTP endpoints
- verify k6 JavaScript API signatures and options
- debug test lifecycle hooks and iteration failures

## Example prompts
- Generate a k6 script with ramp-up stages and a 95th percentile latency threshold
- Look up the syntax for handling custom metrics and checks in k6
- Write an HTTP POST performance test sending JSON payloads

## Similar
- [k6-perf-test-website](https://affpapa.org/en/nevibecode/skills/k6-perf-test-website.md) — skill · 3800 installs
- [api-test-suite-builder](https://affpapa.org/en/nevibecode/skills/borghei-api-test-suite-builder.md) — skill · 111 installs
- [performance-testing](https://affpapa.org/en/nevibecode/skills/performance-testing.md) — skill · 1500 installs
- [k6](https://affpapa.org/en/nevibecode/skills/k6.md) — skill · 5500 installs
- [151-java-performance-jmeter](https://affpapa.org/en/nevibecode/skills/151-java-performance-jmeter.md) — skill · 374 installs
- [152-java-performance-gatling](https://affpapa.org/en/nevibecode/skills/152-java-performance-gatling.md) — skill · 219 installs

## Other versions with the same name
- [k6-docs · grafana](https://affpapa.org/en/nevibecode/skills/k6-docs.md) — 4600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
