К основному содержанию
скилл CX Codex

testing-perf — скилл для Claude Code: нагрузочные тесты k6, Locust

Скилл testing-perf для Claude Code выполняет нагрузочные тесты через k6 и Locust и распараллеливает pytest с xdist. Включается при написании load-тестов или ускорении прогона набора тестов.

MIT 120 установок ★ 305 обновлён 2026-11-07

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill testing-perf -a claude-code
Открыть на GitHub

Что делает testing-perf

Внутри правила для k6 (пороги, стадии, метрики), Locust (весовые задачи, сценарии авторизации), классификация типов тестов (load, stress, spike, soak), шаблоны pytest-маркеров и настройки xdist для параллельного выполнения с изоляцией БД по воркерам. Требует k6 1.0+ или Locust 2.46.6+. Совместим с Claude Code 2.1.277+.

В k6 v1.0 встроен TypeScript, убран путь k6/experimental/browser (теперь k6/browser), добавлен OTLP-вывод. Для тестов с БД показан fixture с worker_id, чтобы каждый воркер xdist писал в отдельную копию базы.

Какие задачи решает

  • написать load-тест с порогами p95 и заданным числом виртуальных пользователей
  • ускорить прогон pytest-сьюта через параллельные воркеры и группировку по scope
  • изолировать БД между воркерами xdist, чтобы тесты не конфликтовали
  • выбрать между k6 и Locust под задачу команды и CI
  • настроить staged ramp-up для нагрузочного сценария

Примеры запросов агенту

  • Напиши k6-тест с трёхэтапным ramp-up: 30 секунд до 20 VU, минута steady state, 30 секунд до нуля
  • Добавь pytest-xdist с изоляцией БД по воркерам и coverage
  • Покажи Locust-сценарий с весовыми задачами и порогом ошибок меньше 1%

Как установить testing-perf

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill testing-perf -a claude-code

2Вручную: положить файлы

~/.claude/skills/testing-perf/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/testing-perf/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о testing-perf

Как установить testing-perf в Claude Code?

Выполни npx skills add yonatangross/orchestkit --skill testing-perf -a claude-code, затем открой ~/.claude/skills/testing-perf/SKILL.md.

Что делает testing-perf?

Даёт правила и шаблоны для нагрузочного тестирования k6 и Locust, параллельного запуска pytest через xdist с изоляцией БД, выбора типа теста (load, stress, spike, soak) и настройки порогов метрик.

Какая версия k6 нужна для testing-perf?

Скилл рассчитан на k6 1.0+. В этой версии встроен TypeScript и удалён путь k6/experimental/browser — теперь import browser from 'k6/browser'.

Исходный текст

SKILL.md · MIT
---
name: testing-perf
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "Load and performance tests with k6 and Locust, plus pytest speed (xdist). Use when writing load tests or speeding up a test suite."
user-invocable: false
disable-model-invocation: false
targets:
  - library: "k6"
    version: ">=1.0.0"
  - library: "locust"
    version: ">=2.46.6"
metadata:
  owner-agent: "test-generator"
  category: document-asset-creation
  version: "2.1.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "testing, performance, k6, locust, pytest, load-testing, benchmarking"
allowed-tools: "Read Glob Grep WebFetch WebSearch"
---

# Performance & Load Testing Patterns

Focused skill for performance testing, load testing, and pytest execution optimization. Covers k6, Locust, pytest-xdist parallel execution, custom plugins, and test type classification.

## Quick Reference

| Area | File | Purpose |
|------|------|---------|
| **k6 Load Testing** | `rules/perf-k6.md` | Thresholds, stages, custom metrics, CI integration |
| **Locust Testing** | `rules/perf-locust.md` | Python load tests, task weighting, auth flows |
| **Test Types** | `rules/perf-types.md` | Load, stress, spike, soak test patterns |
| **Execution** | `rules/execution.md` | Coverage reporting, parallel execution, failure analysis |
| **Pytest Markers** | `rules/pytest-execution.md` | Custom markers, xdist parallel, worker isolation |
| **Pytest Plugins** | `rules/pytest-plugins.md` | Factory fixtures, plugin hooks, anti-patterns |
| **k6 Patterns** | `references/k6-patterns.md` | Staged ramp-up, authenticated requests, test types |
| **xdist Parallel** | `references/xdist-parallel.md` | Distribution modes, worker isolation, CI config |
| **Custom Plugins** | `references/custom-plugins.md` | conftest plugins, installable plugins, hook reference |
| **Perf Checklist** | `checklists/performance-checklist.md` | Planning, setup, metrics, load patterns, analysis |
| **Pytest Checklist** | `checklists/pytest-production-checklist.md` | Config, markers, parallel, fixtures, CI/CD |
| **Test Template** | `scripts/test-case-template.md` | Full test case documentation template |

## k6 Quick Start

Set up a load test with thresholds and staged ramp-up:

```javascript
import http from 'k6/http';
import { check, sleep } from 'k6';

export const options = {
  stages: [
    { duration: '30s', target: 20 },  // Ramp up
    { duration: '1m', target: 20 },   // Steady state
    { duration: '30s', target: 0 },   // Ramp down
  ],
  thresholds: {
    http_req_duration: ['p(95)<500'],  // 95th percentile under 500ms
    http_req_failed: ['rate<0.01'],    // Less than 1% error rate
  },
};

export default function () {
  const res = http.get('http://localhost:8000/api/health');
  check(res, {
    'status is 200': (r) => r.status === 200,
    'response time < 200ms': (r) => r.timings.duration < 200,
  });
  sleep(1);
}
```

Run: `k6 run --out json=results.json tests/load/api.js`

### k6 v1.0+ (May 2025) — what changed

- **Native TypeScript**: `k6 run tests/load/api.ts` — no compilation step needed.
- **Auto extension provisioning**: `k6 run` pulls required extensions automatically; manual `xk6 build` is superseded for most workflows.
- **Browser module import**: `import browser from 'k6/browser'` — **the old `k6/experimental/browser` path was removed in v0.52+**. Any generated code using `/experimental/` will fail.
- **OTLP output built in**: `k6 run --out experimental-opentelemetry=...` — stream results straight to your tracing backend.

```typescript
import http from 'k6/http'
import browser from 'k6/browser'
import { check } from 'k6'

export const options = { vus: 5, duration: '30s' }

export default async function () {
  const page = await browser.newPage()
  await page.goto('https://example.com')
  check(page, { 'title present': async p => (await p.title()).length > 0 })
  await page.close()
}
```

## Performance Test Types

| Type | Duration | VUs | Purpose | When to Use |
|------|----------|-----|---------|-------------|
| **Load** | 5-10 min | Expected traffic | Validate normal conditions | Every release |
| **Stress** | 10-20 min | 2-3x expected | Find breaking point | Pre-launch |
| **Spike** | 5 min | Sudden 10x surge | Test auto-scaling | Before events |
| **Soak** | 4-12 hours | Normal load | Detect memory leaks | Weekly/nightly |

## pytest Parallel Execution

Speed up test suites with pytest-xdist:

```toml
# pyproject.toml
[tool.pytest.ini_options]
addopts = ["-n", "auto", "--dist", "loadscope"]
markers = [
    "slow: marks tests as slow",
    "smoke: critical path tests for CI/CD",
]
```

```bash
# Run with parallel workers and coverage
pytest -n auto --dist loadscope --cov=app --cov-report=term-missing --maxfail=3

# CI fast path — skip slow tests
pytest -m "not slow" -n auto

# Debug mode — single worker
pytest -n 0 -x --tb=long
```

## Worker Database Isolation

When running parallel tests with databases, isolate per worker:

```python
@pytest.fixture(scope="session")
def db_engine(worker_id):
    db_name = f"test_db_{worker_id}" if worker_id != "master" else "test_db"
    engine = create_engine(f"postgresql://localhost/{db_name}")
    yield engine
    engine.dispose()
```

## Key Thresholds

| Metric | Target | Tool |
|--------|--------|------|
| p95 response time | < 500ms | k6 |
| p99 response time | < 1000ms | k6 |
| Error rate | < 1% | k6 / Locust |
| Business logic coverage | 90% | pytest-cov |
| Critical path coverage | 100% | pytest-cov |

## Decision Guide

| Scenario | Recommendation |
|----------|----------------|
| JavaScript/TypeScript team | k6 for load testing |
| Python team | Locust for load testing |
| Need CI thresholds | k6 (built-in threshold support) |
| Need distributed testing | Locust (built-in distributed mode) |
| Slow test suite | pytest-xdist with `-n auto` |
| Flaky parallel tests | `--dist loadscope` for fixture grouping |
| DB-heavy tests | Worker-isolated databases with `worker_id` |

## Related Skills

- `ork:testing-unit` — Unit testing patterns, pytest fixtures
- `ork:testing-e2e` — End-to-end performance testing with Playwright
- `ork:performance` — Core Web Vitals and optimization patterns

© OrchestKit · MIT · yonatangross/orchestkit

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
Load Testing taste f Промпт Load Testing taste для ChatGPT задаёт стандарты нагрузочного тестирования. Он используется при проектировании сценариев и анализе предельных возможностей сервисов. GP ChatGPT ★ 178 201звёзд репо k6-perf-test-website grafana Скилл k6-perf-test-website разворачивает гибридные нагрузочные тесты сайта на k6, связывает протокольные сценарии с проверками в браузере и следит за нагрузкой генератора. CX Codex +1 3 800установок performance-testing kindlmann Скилл performance-testing помогает настроить нагрузочные тесты k6 и замеры Core Web Vitals через Lighthouse CI, превращая бюджеты производительности в блокирующие проверки в пайплайне. CX Codex +1 1 500установок stress-testing aj-geddes Скилл stress-testing для нагрузочного стресс-тестирования: помогает найти точку отказа, проверить автоскейлинг и восстановление после перегрузки. CX Codex +1 506установок setup-load-testing davila7 Команда setup-load-testing настраивает нагрузочное тестирование сервиса в Claude Code: сканирует проект, подбирает инструмент вроде k6 или Artillery и создаёт сценарии проверки производительности. CX Codex +1 235установок agent-performance-engineer Tony363 Скилл agent-performance-engineer для Claude Code помогает находить узкие места и настраивать производительность приложений, баз данных и инфраструктуры. Активируется для задач по профилированию, нагрузочному тестированию и оптимизации. CX Codex +1 556установок

Из того же набора86

Весь набор →
visualize-plan Скилл visualize-plan показывает план изменений в виде схемы «до и после», карты рисков и порядка выполнения. Запускается при разборе плана или изменений в текущей ветке. CX Codex +1 124установок market-sizing Скилл market-sizing считает TAM, SAM и SOM двумя методами — top-down и bottom-up — и сверяет их. Запускается при подготовке слайдов для питча или оценке размера рынка. CX Codex +1 124установок ai-ui-generation Скилл ai-ui-generation для Claude Code и Codex задаёт правила генерации, аудита и встраивания интерфейсных компонентов из нейросетей. Включается при сборке UI и подготовке визуального вывода MCP. CX Codex +1 123установок product-analytics Скилл product-analytics разбирает A/B-тесты, удержание когорт и воронки, чтобы принять решение по эксперименту или найти провал конверсии. CX Codex +1 120установок chain-patterns Скилл chain-patterns собирает паттерны для многофазных пайплайнов: обнаружение MCP, handoff-файлы, возобновление после сбоя и изолированные worktree-агенты. CX Codex +1 118установок design-to-code Скилл design-to-code для Claude Code преобразует скриншоты, текстовые описания и URL страниц в компоненты React. Запускается при вёрстке интерфейсов по макетам с повторным использованием готовых блоков проекта. CX Codex +1 116установок testing-unit Скилл testing-unit задаёт шаблоны для модульных тестов, моков HTTP и фикстур в Vitest, Jest и pytest. Включается при написании тестов или настройке тестовых данных. CX Codex +1 116установок design-context-extract Скилл design-context-extract извлекает цвета, типографику, отступы, компоненты и анимации из скриншотов, URL или записи экрана. Результат отдаёт в токенах или конфигурации Tailwind. CX Codex +1 112установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой