api-load-tester

Load tests HTTP API endpoints with progressive concurrency and generates latency and throughput reports.

1|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/th-efool/SKILLS --skill api-load-tester-th-efool
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-load-tester
Source: https://github.com/th-efool/SKILLS/tree/main/api-load-tester
Command: npx skills add https://github.com/th-efool/SKILLS --skill api-load-tester-th-efool

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It answers whether an API can survive real traffic by stress-testing endpoints under increasing concurrency, measuring latency percentiles, error rates, and throughput, and pinpointing the exact breaking point and bottleneck. ## Core Features & Use Cases - Progressive Concurrency Testing: Ramps load from 1 to 500+ concurrent users in staged steps using hey, wrk, ab, or a curl fallback. - Breaking Point & Bottleneck Analysis: Detects the concurrency level where errors spike or latency cliffs occur, and classifies the bottleneck as CPU, memory, I/O, connection pool, or rate limiting. - Structured Report Generation: Produces api-load-report.md with latency percentile tables, ASCII throughput and latency charts, capacity estimates, and prioritized recommendations. - Use Case: Before launching a new product, run the skill against your staging API to confirm p95 latency stays under 300ms at 100 concurrent users and identify whether the database connection pool is the first thing to fail. ## Quick Start Load test https://api.example.com/health with up to 100 concurrent users and a p95 latency target under 200ms.

Frequently Asked Questions about api-load-tester

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I load test an API endpoint with hey or wrk?▼

Run hey with -n for total requests, -c for concurrency, and -t for timeout, adding -H flags for auth headers and -d for request bodies. The skill checks for hey first, then wrk, then ab, falling back to curl with background bash processes if none are installed.

What is the breaking point in API load testing?▼

The breaking point is the concurrency level where the error rate exceeds 1%, p95 latency exceeds 5x baseline, throughput drops versus the previous stage, or more than 5% of connections are refused. The report names which condition triggered it.

Can I load test POST endpoints with authentication?▼

Yes, POST, PUT, and DELETE endpoints with Bearer tokens and JSON bodies are supported, but the skill asks for confirmation that the endpoint is idempotent or side-effect free. Auth tokens are masked in all output and reports.

Is it safe to load test a production API?▼

The skill never load-tests production without explicit user confirmation and warns when the URL appears to be a production domain. It also respects 429 rate limits by reducing concurrency instead of continuing to hammer the endpoint.

Why does my load test fail with connection errors at high concurrency?▼

Connection errors at high concurrency usually indicate OS-level file descriptor limits on the client machine or connection pool exhaustion on the server. The skill detects these errors, suggests increasing ulimit -n, and classifies the bottleneck in the report.

What metrics does an API load test report include?▼

The report includes p50 through p99 latency percentiles per concurrency stage, throughput in requests per second, error breakdowns by status code and type, ASCII throughput and latency charts, bottleneck classification, and capacity scaling projections.