Skip to main content
skill CX Codex

152-java-performance-gatling — Claude Code skill: how to install

152-java-performance-gatling sets up Gatling load testing in a Java Maven project: dependencies, the Maven plugin, simulations, and runs via ./mvnw gatling:test.

Apache-2.0 219 installs ★ 465 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jabrena/plinth --skill 152-java-performance-gatling -a claude-code
Open on GitHub

What 152-java-performance-gatling does

The skill edits pom.xml to add Gatling test-scope dependencies and io.gatling:gatling-maven-plugin, then writes Java simulations under src/test/java. Extras such as gatling.conf, feeders, request-body templates or logback-test.xml go into src/test/resources, and only when the project needs them.

Runs go through ./mvnw gatling:test. With several simulations in the project, it passes -Dgatling.simulationClass=<FullyQualifiedClassName> so the run needs no prompt. When the run ends, it points to the report path printed in the command output and summarizes failed assertions.

Maven is a hard requirement. On a Gradle or sbt project the skill stops and says so before offering anything else. If the build has no Gatling versions yet, it asks which ones to pin or leaves placeholders you have to replace.

What it helps with

  • add Gatling and gatling-maven-plugin to pom.xml
  • write a Java simulation with explicit scenarios, injection profile and assertions
  • pick one simulation out of several and run it non-interactively
  • wire up feeders and request-body templates from src/test/resources
  • locate the report after a run and read the failed assertions

Example prompts for the agent

  • Add Gatling performance testing to this Maven project
  • Create a Gatling simulation in src/test/java for this service
  • Run only one simulation with -Dgatling.simulationClass=<FullyQualifiedClassName>

How to install 152-java-performance-gatling

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 152-java-performance-gatling -a claude-code

2Manually: put the files in place

~/.claude/skills/152-java-performance-gatling/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/152-java-performance-gatling/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 152-java-performance-gatling

How do I install 152-java-performance-gatling in Claude Code?

Run npx skills add jabrena/plinth --skill 152-java-performance-gatling -a claude-code. The skill file ends up at ~/.claude/skills/152-java-performance-gatling/SKILL.md.

What does 152-java-performance-gatling do?

It wires Gatling into a Maven project: adds the dependencies and plugin to pom.xml, creates Java simulations, runs them with ./mvnw gatling:test and helps you read the report.

Does the skill work with Gradle projects?

No, it targets Maven. On any other build it stops and explains that before suggesting alternatives.

Source text

SKILL.md · Apache-2.0
---
name: 152-java-performance-gatling
description: Use when you need to set up Gatling performance testing for a Java Maven project — including adding Gatling dependencies and the Gatling Maven plugin, creating Java simulations, running gatling:test, configuring a simulation class, and reviewing generated reports. This should trigger for requests such as Add Gatling performance testing; Apply Gatling performance testing; Create a Gatling simulation; Add Gatling support; Review Gatling performance test assertions and feeders. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Run performance tests based on Gatling

Provide a complete Gatling performance testing setup for Java Maven projects by adding the required test dependencies and Gatling Maven plugin configuration, creating or guiding Java simulation placement, and explaining how to run simulations and inspect reports.

**What is covered in this Skill?**

- Add Gatling dependencies and the `gatling-maven-plugin` to `pom.xml`
- Project structure: `src/test/java` for Java simulations and `src/test/resources` for Gatling configuration, feeders, templates, and logging
- Run simulations with `./mvnw gatling:test`
- Select a simulation with `-Dgatling.simulationClass=<FullyQualifiedClassName>` when multiple simulations exist
- Use `./mvnw gatling:help -Ddetail=true -Dgoal=test` to inspect available plugin options
- Review generated Gatling run output and reports under the build output directory

**Scope:** Use Gatling through the Maven plugin for Java simulations. Prefer project-local Maven wrapper commands when available.

## Constraints

Gatling setup must be Maven-based, reproducible, and compatible with Java project conventions. Prefer official Gatling Maven plugin behavior and avoid inventing unsupported command-line options.

- **PREREQUISITE**: Verify the project is Maven-based and prefer `./mvnw` when the Maven wrapper exists
- **BUILD CONFIGURATION**: Add Gatling dependencies with test scope and configure `io.gatling:gatling-maven-plugin` in `pom.xml`
- **VERSION SELECTION**: Use the project's existing dependency/version-management pattern; if no Gatling versions are present, ask before pinning versions or use placeholders that require replacement
- **SIMULATION LOCATION**: Place Java simulations under `src/test/java` using an appropriate package name
- **RESOURCE LOCATION**: Place Gatling resources such as `gatling.conf`, feeders, request-body templates, and Logback test configuration under `src/test/resources`
- **BEFORE APPLYING**: Read the reference for setup, execution, and verification guidance
- **EDGE CASE**: If the project is not Maven-based, stop and explain that this skill targets Maven projects before suggesting Gradle or sbt alternatives
- **EDGE CASE**: If multiple simulations exist, configure or pass `-Dgatling.simulationClass=<FullyQualifiedClassName>` for non-interactive execution

## When to use this skill

- Add Gatling performance testing
- Apply Gatling performance testing
- Create a Gatling simulation
- Add Gatling support
- Review Gatling performance test assertions and feeders

## Workflow

1. **Inspect the Maven project**

Check for `pom.xml`, the Maven wrapper, existing test dependencies, dependency management, plugin management, and any existing Gatling configuration.

2. **Add Gatling build configuration**

Add the Gatling test dependency and `io.gatling:gatling-maven-plugin` using the project's existing version and plugin configuration style.

3. **Create or adapt Java simulations**

Create Java simulation classes under `src/test/java` or adapt existing simulations, keeping scenario names, base URLs, injection profiles, and assertions explicit.

4. **Configure resources**

Add optional Gatling resources under `src/test/resources`, including `gatling.conf`, feeders, request body templates, and `logback-test.xml` only when the project needs them.

5. **Run and explain Gatling execution**

Use `./mvnw gatling:test` to run simulations and `-Dgatling.simulationClass=<FullyQualifiedClassName>` when a specific simulation must be selected.

6. **Verify reports and next steps**

Confirm the Gatling run completed, point to the generated report location from the command output, and summarize any failed assertions or performance findings.

## Reference

For detailed guidance, examples, and constraints, see [references/152-java-performance-gatling.md](references/152-java-performance-gatling.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Similar skills

All skills for Testing and QA →

From the same set123

The whole set →
300-frameworks-spring-boot-create-project 300-frameworks-spring-boot-create-project scaffolds Maven-based Spring Boot 4.0.x projects using Java 25 and SDKMAN tools. Useful when starting new backend services with automated build verification. CX Codex +1 225installs 706-technologies-containers-docker 706-technologies-containers-docker is a Claude Code skill for reviewing Java Dockerfiles, Maven image builds, jlink runtimes, and container security. CX Codex +1 225installs 003-skills-inventory 003-skills-inventory generates a Java system prompt checklist document in INVENTORY-SKILLS-JAVA.md from skills.xml. Useful for maintaining skill registries in Plinth Toolkit. CX Codex +1 224installs 001-commands-inventory The 001-commands-inventory skill builds INVENTORY-COMMANDS-JAVA.md from an embedded Java command template. Use it when a project needs a fixed command inventory checklist. CX Codex +1 220installs 004-commands-installation 004-commands-installation copies embedded project commands into selected assistant directories through an interactive setup prompt. CX Codex +1 219installs 005-agents-installation The 005-agents-installation skill copies the project’s embedded agent definitions into a directory you choose. Use it to set up .claude/agents or another supported destination. CX Codex +1 219installs 705-technologies-nosql-mongodb 705-technologies-nosql-mongodb — a skill for Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI that covers MongoDB at the database layer, independent of Spring Boot, Quarkus or Micronaut. CX Codex +1 216installs 807-regulations-eu-digital-services-act 807-regulations-eu-digital-services-act reviews Java systems for Digital Services Act engineering controls across moderation, complaints, recommendations, advertising, and transparency. CX Codex +1 215installs

Project sponsors

Companies that keep this analytics open