api-load-tester — скилл для Claude Code: нагрузочное тестирование API
Скилл api-load-tester для Claude Code, Codex, Cursor и других платформ запускает нагрузочное тестирование HTTP-эндпоинтов с нарастающей конкурентностью.
MIT 260 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a claude-codeЧто делает api-load-tester
Перед запуском сам выбирает инструмент нагрузки: проверяет наличие hey, wrk, ab и curl в указанном порядке; если ни одного нет — устанавливает hey через brew или go install. Одиночным запросом валидирует каждый эндпоинт и измеряет базовую задержку.
Далее скилл строит ступенчатый план нагрузки от 1 до 100 конкурентных пользователей (диапазон можно задать вручную), показывает план на согласование и запускает этапы последовательно с паузой 2 секунды между ними. По умолчанию тестирует только GET-запросы — для других методов нужно явно передать метод, заголовки и тело. Пороги задержки по умолчанию: p50 < 100 мс, p95 < 300 мс, p99 < 1000 мс.
По итогам скилл записывает api-load-report.md в рабочую директорию: ASCII-графики пропускной способности и задержек, таблица масштабирования, точка слома нагрузки и конкретные рекомендации. Auth-токены в выводе маскируются, а тестировать продакшн скилл попросит подтвердить явно — без подтверждения не пойдёт.
Какие задачи решает
- найти точку слома API под нарастающей нагрузкой
- измерить p50, p95 и p99 задержки по этапам конкурентности
- построить кривую пропускной способности эндпоинта
- выявить узкое место до выхода в продакшн
- сформировать читаемый отчёт с ASCII-графиками для команды
Примеры запросов агенту
- Запусти нагрузочный тест
POST /api/ordersсо 100 конкурентными пользователями, заголовокAuthorization: Bearer <token>, порог p95 < 500 мс - Прогони
api-load-testerдля эндпоинтаGET /api/productsна staging, диапазон конкурентности 1–50, длительность этапа 30 секунд - Протестируй три эндпоинта из
endpoints.txtи запиши результат вapi-load-report.md
Как установить api-load-tester
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a claude-code2Вручную: положить файлы
~/.claude/skills/api-load-tester/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-load-tester/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a codex2Вручную: положить файлы
.agents/skills/api-load-tester/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a cursor2Вручную: положить файлы
.cursor/skills/api-load-tester/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills api-load-tester2Вручную: положить файлы
.github/skills/api-load-tester/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path api-load-testerВручную: положить файлы
.devin/skills/api-load-tester/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-load-tester -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об api-load-tester
Как установить api-load-tester в Claude Code?
Выполните npx skills add OneWave-AI/claude-skills --skill api-load-tester -a claude-code. Скилл появится по пути ~/.claude/skills/api-load-tester/SKILL.md.
Что делает скилл api-load-tester?
Он прогоняет HTTP-эндпоинты через нарастающие этапы конкурентной нагрузки, считает перцентили задержек, пропускную способность и процент ошибок, определяет точку слома и пишет отчёт api-load-report.md с рекомендациями.
Нужен ли отдельный инструмент нагрузочного тестирования для работы скилла?
Скилл сам проверяет наличие hey, wrk или ab. Если ни одного нет, установит hey автоматически — через brew install hey на macOS или go install github.com/rakyll/hey@latest на Linux при наличии Go. Если Go тоже нет, сработает fallback на curl с bash-процессами в фоне.
Исходный текст
SKILL.md · MIT
--- name: api-load-tester description: Load tests API endpoints with progressive concurrency. Measures response times, error rates, throughput, and identifies breaking points. Generates a detailed report with latency percentiles, throughput curves, bottleneck analysis, and optimization recommendations. tools: Bash, Read, Write, Glob, Grep model: inherit --- # API Load Tester Stress-test HTTP endpoints under increasing load, identify breaking points, and produce a report with actionable recommendations. ## Contents - `references/tool-commands.md` -- tool invocations (hey/wrk/ab/curl), default concurrency stages, per-stage data to capture. - `references/metrics-interpretation.md` -- latency, throughput, error, breaking-point, and bottleneck classification. - `references/output-template.md` -- exact structure for `api-load-report.md`, including ASCII charts and scaling table. - `references/rules-and-examples.md` -- safety rules, error handling, and example invocations. ## Inputs Collect from the user. Ask before proceeding if a required input is missing. **Required**: endpoint URL(s) (with method, headers, body as needed); expected latency thresholds. Default thresholds if unspecified: p50 < 100ms, p95 < 300ms, p99 < 1000ms. **Optional**: concurrent users or range (default ramp 1 to 100); authentication; request payloads; custom headers; test duration (default 10s per stage); ramp pattern (default step ramp, doubling each stage); success criteria (default 2xx); known rate limits; environment label (prod/staging/dev). ## Workflow Follow these steps in order. 1. **Select a tool.** Check in priority order: `which hey`, `which wrk`, `which ab`, `which curl`. If none of hey/wrk/ab exist, install hey (`brew install hey` on macOS, `go install github.com/rakyll/hey@latest` on Linux with Go) or fall back to curl with bash background processes and `wait`. Verify with a single trivial request against a provided endpoint; diagnose connectivity or auth before continuing. 2. **Validate endpoints.** Send one request per endpoint with the specified method, headers, auth, and body. Confirm the status matches the success criteria and record baseline single-request latency. On failure, surface the error and ask whether to skip or fix. 3. **Design the test plan.** Build progressive concurrency stages (see `references/tool-commands.md` for the default progression), trimming or extending to the user's concurrency range. Define per-endpoint method, URL, headers, body, success codes, and timeout (default 30s). Print the plan for review before executing. 4. **Execute stages.** For each endpoint, run every concurrency stage sequentially with the selected tool, waiting 2 seconds between stages. Capture and store the per-stage metrics. See `references/tool-commands.md` for commands, request-count formula, and the metrics list. 5. **Interpret metrics.** Compute latency percentiles and profile, throughput curve and ceiling, error rates and onset, the breaking point, and the bottleneck classification. See `references/metrics-interpretation.md`. 6. **Generate the report.** Write `api-load-report.md` to the current working directory following `references/output-template.md` exactly, including ASCII throughput and latency charts. 7. **Post-report actions.** Print a 3-5 line summary to the console, state the report path, explicitly highlight any critical issues, and offer to re-run specific stages with different parameters. ## Rules Apply the safety rules, error handling, and example invocations in `references/rules-and-examples.md`. Key constraints: never load-test production without explicit confirmation, only test GET by default, mask auth tokens, respect 429 rate limits, count timeouts as failures, and never extrapolate beyond tested ranges.
© OneWave-AI · MIT · OneWave-AI/claude-skills