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
- Repository
- jeremylongshore/tons-of-skills-marketplace
- 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
- 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.
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.
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
- 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)
- Identify test scenarios
- User journeys to simulate
- API endpoints to test
- Realistic traffic patterns
- Peak usage times
- Configure test parameters
- Virtual users (concurrent connections)
- Ramp-up time (gradual increase)
- Test duration
- Think time between requests
- Data variation
- 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
- Pre-test validation
- Verify test environment is ready
- Check monitoring tools are active
- Ensure database is seeded
- Validate baseline performance
- Execute test
- Start monitoring (CPU, memory, network)
- Run load test with specified parameters
- Capture real-time metrics
- Log errors and warnings
- Monitor during test
- Watch response times
- Track error rates
- Observe resource utilization
- Check database performance
- Collect results
- Response time percentiles
- Throughput metrics
- Error logs and types
- Resource usage graphs
For Analysis
- Performance metrics
- Analyze response time distribution
- Identify slow endpoints
- Calculate throughput capacity
- Determine concurrent user limits
- 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
- 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
- Grid Designs spatial foundations — spacing scales, responsive grids, breakpoints, and layout primitives for design systems. Use when creating or auditing layout systems for a product. Trigger with \"design a layout system\", \"audit our grid\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Helm Chart Generate Helm charts for Kubernetes applications Slash Command · jeremylongshore/tons-of-skills-marketplace
- Hex Pack Claude Code skill pack for Hex (18 skills) Plugin · jeremylongshore/tons-of-skills-marketplace
- Hermes Tweet Native Hermes Agent X/Twitter plugin for Xquik automation with read-first workflows and approval-gated actions. Plugin · jeremylongshore/tons-of-skills-marketplace
- Phish Designs phishing simulation programs, security awareness curricula, and social engineering assessments that drive behavior change through immediate feedback and difficulty progression. Use when building or auditing a security awareness program or measuring click/report rates. Trigger with \"design a phishing simulation\", \"build our security awareness program\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Performance Optimizer Scans codebases for N+1 queries, blocking I/O in async handlers, bundle bloat, unnecessary React re-renders, and O(n²) algorithm patterns — classifying findings by impact before flagging for human review. Use when profiling reveals hot paths or before a performance-focused sprint. Trigger with \"find performance issues\", \"audit N+1 queries\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Pitch Runs the Dunford five-step positioning framework and writes the output — homepage copy, launch announcements, email, taglines, and GTM plans that name specific distribution channels. Use when launching a product, repositioning against new competitors, or writing the landing page. Trigger with \"position this product\", \"write the launch copy\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Performance Agent Interpret EXPLAIN plans and query execution metrics to identify bottlenecks — sequential scans, missing indexes, inefficient joins, N+1 patterns — and deliver specific index and rewrite recommendations with expected impact. Use when investigating slow queries or tuning a database under load. Trigger with \"analyze query performance\", \"review EXPLAIN plan\". Subagent · jeremylongshore/tons-of-skills-marketplace