grafana-k6-skills

k6 Skills for Claude Code

A Claude Code plugin that provides comprehensive skills for Grafana k6 load testing. Generate test scripts, design load scenarios, analyze results, and operate k6 infrastructure — all through natural language conversations.

Table of Contents

• Overview
• Skills
• Installation
• Usage
• Project Structure
• Prerequisites
• Contributing
• License
• Acknowledgments

Overview

This plugin extends Claude Code with 8 specialized skills covering the full k6 load testing lifecycle. Each skill contains curated reference documentation synthesized from official k6 docs, enabling Claude to generate accurate, production-ready k6 test scripts and configurations.

What this plugin helps you do:

• Generate load test scripts for HTTP/REST, gRPC, and WebSocket APIs
• Create browser-based performance tests with Web Vitals measurement
• Auto-generate k6 tests from existing codebases or OpenAPI specifications
• Design load profiles with the right executors, scenarios, and thresholds
• Analyze test results, identify bottlenecks, and optimize performance
• Set up k6 in CI/CD pipelines and Kubernetes distributed environments
• Build chaos engineering tests with fault injection

Skills

Test Generation

Skill	Description
generating-api-load-tests	Generate k6 scripts for HTTP/REST, gRPC, and WebSocket. Covers authentication, data parameterization, CRUD patterns, batch requests, and streaming.
generating-browser-tests	Create browser-based E2E performance tests using k6's Chromium module. Measure Core Web Vitals (LCP, FCP, CLS, INP, TTFB) and simulate user interactions.
generating-tests-from-code	Analyze existing API codebases (Express, NestJS, Spring Boot, FastAPI, Django) to auto-generate k6 tests. Detects authentication middleware and protected endpoints.
generating-tests-from-openapi	Generate k6 tests from OpenAPI 3.0/3.1 specifications. Extracts endpoints, parameters, request schemas, and security schemes to produce complete test suites.

Test Design & Analysis

Skill	Description
designing-test-scenarios	Design load profiles with the right executor (ramping-vus, constant-arrival-rate, etc.), configure multi-scenario orchestration, and set pass/fail thresholds.
analyzing-test-results	Interpret k6 output, analyze HTTP timing breakdowns, identify bottleneck patterns, and provide optimization recommendations.

Infrastructure & Operations

Skill	Description
operating-k6-in-ci-cd	Set up k6 in CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins), run distributed tests with k6-operator on Kubernetes, and manage xk6 extensions.
testing-resilience	Create chaos engineering tests using xk6-disruptor. Inject faults (HTTP errors, network delays, pod termination) into Kubernetes services during load tests.

Installation

Plugin Installation (Recommended)

Install via Claude Code's plugin marketplace for automatic updates:

/plugin marketplace add KimDoubleB/grafana-k6-skills
/plugin install k6@KimDoubleB-grafana-k6-skills

After installation, the skills are available in all your Claude Code sessions.

Standalone Skill Installation

Extract the skill folders manually:

git clone --depth 1 https://github.com/KimDoubleB/grafana-k6-skills.git /tmp/k6-skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/k6-skills-temp/plugins/grafana-k6-skills/skills/* ~/.claude/skills/ && \
rm -rf /tmp/k6-skills-temp

Verify Installation

After installation, you can verify the plugin is loaded by asking Claude Code:

What k6 skills do you have available?

Usage

Skills are automatically activated when Claude detects a relevant context. You can also invoke them explicitly using the /k6:<skill-name> syntax.

Generate an API Load Test

Create a k6 load test for my REST API at https://api.example.com/users
that tests GET, POST, and DELETE endpoints with Bearer token authentication.

Or explicitly:

/k6:generating-api-load-tests

Generate a gRPC load test for the UserService with streaming support.

Design Test Scenarios

/k6:designing-test-scenarios

I need a stress test that gradually increases from 50 to 500 virtual users
over 10 minutes, holds for 30 minutes, then ramps down.

Generate Tests from Code

/k6:generating-tests-from-code

Analyze the Spring Boot API in this project and generate k6 load tests
for all REST endpoints, including authentication setup.

Generate Tests from OpenAPI Spec

/k6:generating-tests-from-openapi