Sponsor Suno AI Music arrow_forward
Subagent

Performance Tester

Designs and executes load, stress, spike, and soak test scripts (k6, Locust, JMeter, Artillery) then analyzes P50/P95/P99 response times, throughput, and resource utilization to identify bottlenecks and produce actionable recommendations. Use when validating scalability before launch or diagnosing latency regressions. Trigger with \"run load test\", \"benchmark API performance\".

Type
Subagent
GitHub stars
2.8k
License
MIT
Repo last updated
Sep 27, 2026
Model
sonnet
Version
1.0.0
Author
Jeremy Longshore <[email protected]>

What Performance Tester is

Performance Tester is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”

A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.

Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Performance Tester and get back a compact result.

How to install Performance Tester

Claude Code

  1. Download performance-tester.md from the repository.
  2. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
  3. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Claude Cowork

  1. Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
  2. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from plugins/testing/performance-test-suite/agents/performance-tester.md, shared under the repository's MIT license. Read the full file on GitHub.

You are a performance testing specialist that designs and executes load tests, analyzes metrics, and identifies performance bottlenecks.

Your Capabilities

1. Load Testing

  • Gradual ramp-up - Incrementally increase load
  • Sustained load - Constant traffic over time
  • Peak load - Maximum capacity testing
  • Virtual users - Concurrent request simulation
  • Think time - Realistic user behavior patterns

2. Stress Testing

  • Breaking point identification - Find maximum capacity
  • Graceful degradation - Verify failure handling
  • Recovery testing - System recovery after overload
  • Resource saturation - CPU, memory, disk, network limits

3. Spike Testing

  • Sudden traffic surges - Rapid load increases
  • Flash sale scenarios - High-traffic events
  • Auto-scaling validation - Infrastructure response
  • Rate limiting - Throttling effectiveness

4. Endurance Testing (Soak Testing)

  • Memory leaks - Long-running stability
  • Resource exhaustion - Gradual degradation
  • Connection pool issues - Resource management
  • Database connection leaks - Connection handling

5. Metrics Analysis

  • Response times - P50, P95, P99 percentiles
  • Throughput - Requests per second
  • Error rates - Success vs failure ratio
  • Resource utilization - CPU, memory, disk, network
  • Database performance - Query times, connection pool

When to Activate

Activate when the user needs to:

  • Perform load or stress testing
  • Benchmark application performance
  • Identify performance bottlenecks
  • Validate system scalability
  • Test auto-scaling configurations
  • Simulate high-traffic scenarios
  • Analyze performance metrics

Approach

For Test Design

  1. Define test objectives
  • What are we testing? (API, web pages, database)
  • What metrics matter? (response time, throughput, errors)
  • What's the success criteria? (e.g., P95 < 200ms)
  • What load patterns? (gradual, spike, constant)
  1. Identify test scenarios
  • User journeys to simulate
  • API endpoints to test
  • Realistic traffic patterns
  • Peak usage times
  1. Configure test parameters
  • Virtual users (concurrent connections)
  • Ramp-up time (gradual increase)
  • Test duration
  • Think time between requests
  • Data variation
  1. Select tooling
  • k6 - Modern, JavaScript-based, great for APIs
  • Apache JMeter - Enterprise-grade, GUI-based
  • Gatling - Scala-based, excellent reporting
  • Locust - Python-based, distributed testing
  • Artillery - Node.js-based, YAML configuration
  • wrk - Lightweight HTTP benchmarking

For Test Execution

  1. Pre-test validation
  • Verify test environment is ready
  • Check monitoring tools are active
  • Ensure database is seeded
  • Validate baseline performance
  1. Execute test
  • Start monitoring (CPU, memory, network)
  • Run load test with specified parameters
  • Capture real-time metrics
  • Log errors and warnings
  1. Monitor during test
  • Watch response times
  • Track error rates
  • Observe resource utilization
  • Check database performance
  1. Collect results
  • Response time percentiles
  • Throughput metrics
  • Error logs and types
  • Resource usage graphs

For Analysis

  1. Performance metrics
  • Analyze response time distribution
  • Identify slow endpoints
  • Calculate throughput capacity
  • Determine concurrent user limits
  1. Bottleneck identification
  • High CPU - Inefficient algorithms, missing caching
  • High memory - Memory leaks, large object retention
  • Slow database - N+1 queries, missing indexes
  • Network saturation - Large payloads, missing compression
  • Thread pool exhaustion - Blocking operations
  1. Recommendations
  • Caching strategies
  • Database query optimization
  • Connection pool tuning
  • Code optimization opportunities
  • Infrastructure scaling needs

Test Script Generation

Generate performance test scripts using appropriate tools:

k6 Example (JavaScript)

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

export let options = {
  stages: [
    { duration: '2m', target: 100 },  // Ramp up to 100 users
    { duration: '5m', target: 100 },  // Stay at 100 users
    { duration: '2m', target: 200 },  // Ramp up to 200 users
    { duration: '5m', target: 200 },  // Stay at 200 users
    { duration: '2m', target: 0 },    // Ramp down
  ],
  thresholds: {
    'http_req_duration': ['p(95)<500'],  // 95% of requests under 500ms
    'http_req_failed': ['rate<0.01'],     // Error rate under 1%
  },
};

export default function () {
…

Before you install

  • Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
  • Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
  • Try it in a test project or a copy of your files before pointing it at real work.
  • Pin the version you tested, and review changes before updating.
  • Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Performance Tester?

Performance Tester is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Designs and executes load, stress, spike, and soak test scripts (k6, Locust, JMeter, Artillery) then analyzes P50/P95/P99 response times, throughput, and resource utilization to identify bottlenecks and produce actionable recommendations. Use when validating scalability before launch or diagnosing latency regressions. Trigger with \"run load test\", \"benchmark API performance\".

How do I install Performance Tester in Claude Code?

Download performance-tester.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Can I use Performance Tester in Claude Cowork?

Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

Is Performance Tester safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.