151-java-performance-jmeter - SKILL.md Agent Skill

name: 151-java-performance-jmeter description: Use when you need to set up JMeter performance testing for a Java project — including creating the run-jmeter.sh script from the exact template, configuring load tests with loops, threads, and ramp-up, or running performance tests from the project root with custom or default settings. This should trigger for requests such as Improve the code with JMeter performance testing; Apply JMeter performance testing; Refactor the code with JMeter performance testing; Add JMeter support. Part of cursor-rules-java project license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.15.0

Run performance tests based on JMeter

Provide a complete JMeter performance testing solution by creating the run-jmeter.sh script from the exact template, making it executable, and configuring the project structure for load testing. Supports custom loops, threads, ramp-up, and environment variable overrides.

What is covered in this Skill?

Create run-jmeter.sh in project root from the exact template (no modifications)
Project structure: src/test/resources/jmeter/load-test.jmx, target/ for results
Script options: -l (loops), -t (threads), -r (ramp-up), -g (GUI), -h (help)
Environment variables: JMETER_LOOPS, JMETER_THREADS, JMETER_RAMP_UP
Verify JMeter is installed and available before proceeding

Scope: Copy the script template verbatim. Do not modify, interpret, or enhance the template content.

Constraints

JMeter must be installed and available in PATH. If not available, show a message and exit. Use only the exact template for the run-jmeter.sh script.

PREREQUISITE: Verify JMeter is installed and accessible via jmeter --version before creating the script
CRITICAL: Copy the run-jmeter.sh template exactly — do not modify, interpret, or enhance
PERMISSION: Make the script executable with chmod +x run-jmeter.sh
BEFORE APPLYING: Read the reference for the exact script template and usage instructions
EDGE CASE: If request scope is ambiguous, stop and ask a clarifying question before applying changes
EDGE CASE: If required inputs, files, or tooling are missing, report what is missing and ask whether to proceed with setup guidance

When to use this skill

Improve the code with JMeter performance testing
Apply JMeter performance testing
Refactor the code with JMeter performance testing
Add JMeter support

Workflow

Verify JMeter prerequisite

Check jmeter --version and stop with guidance if JMeter is not installed or not available in PATH.

Read JMeter reference template

Read references/151-java-performance-jmeter.md and use the run-jmeter.sh template exactly as provided.

Create script and project structure

Create run-jmeter.sh in project root, ensure required JMeter directories/files exist, and apply executable permission with chmod +x.

Explain usage and environment overrides

Document CLI options (-l, -t, -r, -g, -h) and environment variable overrides (JMETER_LOOPS, JMETER_THREADS, JMETER_RAMP_UP).

Reference

For detailed guidance, examples, and constraints, see references/151-java-performance-jmeter.md.