Cursor-rules-java 151-java-performance-jmeter

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. Part of the skills-for-java project

install

source · Clone the upstream repo

git clone https://github.com/jabrena/cursor-rules-java

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jabrena/cursor-rules-java "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/151-java-performance-jmeter" ~/.claude/skills/jabrena-cursor-rules-java-151-java-performance-jmeter && rm -rf "$T"

manifest: skills/151-java-performance-jmeter/SKILL.md

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

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

Reference

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