Stampede Load Test Skill

Run config-driven k6 load tests against any web application.

Commands

Setup

Create a profile for a target application and build the Docker image.

# Create profile from template
bash .claude/skills/stampede/scripts/setup.sh <profile-name> <base-url> [auth-strategy]

# Build Docker image
bash .claude/skills/stampede/scripts/setup.sh --docker

Arguments:

• profile-name — Name for the profile (e.g., myapp)
• base-url — Target application URL (e.g., https://my-app.example.com)
• auth-strategy — Optional: form_login, hmac, api_key, bearer, none (default: none)

Run

Execute a load test pattern against a profile.

# Via skill script
bash .claude/skills/stampede/scripts/run.sh <pattern> --profile <name> [options]

# Or directly via the CLI
./run.sh run --profile <name> --pattern <pattern> [options]

Arguments:

• pattern — One of: smoke, stress, spike, breakpoint, school-bell, concurrency

Options:

• --profile <name> — Profile to use (required)
• --max-vus <n> — Override max VUs
• --duration <time> — Override duration (e.g., 5m, 30s)
• --base-url <url> — Override target URL
• --auth <strategy> — Override auth strategy
• --step <n> — Step size (breakpoint pattern)
• --hold <time> — Hold duration per step
• --docker — Run in Docker instead of locally

List

Show available profiles and patterns.

./run.sh list profiles
./run.sh list patterns

Status

Check available profiles, patterns, and Docker/k6 status.

bash .claude/skills/stampede/scripts/status.sh

Teardown

Clean up Docker images and Railway deployments.

bash .claude/skills/stampede/scripts/teardown.sh [--docker] [--railway]

Workflow

1. Setup: Create a profile for your target → setup.sh myapp https://my-app.com
2. Smoke test: Verify connectivity → run.sh smoke --profile myapp
3. Load test: Run the desired pattern → run.sh spike --profile myapp --max-vus 1000
4. Review: Check k6 output for response times, error rates, and thresholds

Available Patterns

Auth Strategies