testng-skill — Claude Code skill: setup and use
Generates Java TestNG tests with groups, data providers, parallel execution, suite XML, and listeners. Use it when building or organising TestNG coverage.
MIT 243 installs ★ 393 updated 2026-10-13
npx skills add LambdaTest/agent-skills --skill testng-skill -a claude-codeWhat testng-skill does
This skill generates Java tests for TestNG with groups, @DataProvider, method dependencies, soft assertions, and lifecycle annotations. It can also create testng.xml with group filters, package or class selection, and parallel execution at method, class, or test level.
The material includes ITestListener examples, Maven configuration, and commands for running a suite, group, or class. Reports are read from test-output/index.html. The run commands use Maven, and the generated code targets Java with TestNG.
It is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. More detailed patterns are organised in reference/playbook.md, covering drivers, factories, reporting, and CI/CD.
What it helps with
- generate Java TestNG tests with groups
- feed cases into tests through
@DataProvider - configure parallel execution in
testng.xml - attach a listener for failed tests
- run a suite, group, or class with Maven
Example prompts for the agent
- Generate Java TestNG tests for
LoginServicewithsmokeandregressiongroups. - Create an
@DataProviderfor three login cases and addtestng.xmlto run them. - Set up method-level parallel execution in
testng.xmland a listener that prints the failed test name.
How to install testng-skill
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testng-skill -a claude-code2Manually: put the files in place
~/.claude/skills/testng-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/testng-skill/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testng-skill -a codex2Manually: put the files in place
.agents/skills/testng-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testng-skill -a cursor2Manually: put the files in place
.cursor/skills/testng-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills testng-skill2Manually: put the files in place
.github/skills/testng-skill/SKILL.md1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testng-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/LambdaTest/agent-skills --path testng-skillManually: put the files in place
.devin/skills/testng-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill testng-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about testng-skill
How do I install testng-skill in Claude Code?
Run npx skills add LambdaTest/agent-skills --skill testng-skill -a claude-code, then check ~/.claude/skills/testng-skill/SKILL.md.
What does testng-skill do?
It generates Java TestNG tests, groups, data providers, suite XML configuration, parallel execution settings, and listeners.
Which run commands does testng-skill cover?
Use mvn test -DsuiteXmlFile=testng.xml for a suite, mvn test -Dgroups=smoke for a group, or mvn test -Dtest=LoginTest for a class.
Source text
SKILL.md · MIT
---
name: testng-skill
description: >
Generates TestNG tests in Java with groups, data providers, parallel execution,
XML suite configuration, and listeners. Use when user mentions "TestNG",
"@DataProvider", "testng.xml", "groups". Triggers on: "TestNG", "@DataProvider",
"testng.xml", "TestNG suite", "parallel tests Java".
languages:
- Java
category: unit-testing
license: MIT
metadata:
author: TestMu AI
version: "1.0"
---
# TestNG Testing Skill
## Core Patterns
### Basic Test with Groups
```java
import org.testng.annotations.*;
import org.testng.Assert;
public class LoginTest {
@BeforeMethod
public void setUp() { /* setup */ }
@Test(groups = "smoke")
public void testLoginSuccess() {
Assert.assertTrue(loginService.login("[email protected]", "password123"));
}
@Test(groups = "regression", dependsOnMethods = "testLoginSuccess")
public void testAccessDashboard() {
Assert.assertNotNull(dashboard.getContent());
}
@Test(expectedExceptions = AuthenticationException.class)
public void testLoginInvalidPassword() {
loginService.login("[email protected]", "wrong");
}
@AfterMethod
public void tearDown() { /* cleanup */ }
}
```
### Data Providers
```java
@DataProvider(name = "loginData")
public Object[][] loginData() {
return new Object[][] {
{"[email protected]", "admin123", true},
{"[email protected]", "password", true},
{"[email protected]", "wrong", false},
};
}
@Test(dataProvider = "loginData")
public void testLogin(String email, String password, boolean expected) {
Assert.assertEquals(loginService.login(email, password), expected);
}
```
### TestNG XML Suite
```xml
<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd">
<suite name="Regression" parallel="tests" thread-count="5">
<test name="Smoke">
<groups><run><include name="smoke"/></run></groups>
<classes><class name="tests.LoginTest"/></classes>
</test>
<test name="Full">
<groups><run><include name="regression"/><exclude name="flaky"/></run></groups>
<packages><package name="tests.*"/></packages>
</test>
</suite>
```
### Parallel Execution
```xml
<suite parallel="methods" thread-count="5"> <!-- Method level -->
<suite parallel="classes" thread-count="5"> <!-- Class level -->
<suite parallel="tests" thread-count="5"> <!-- Test level -->
```
### Soft Assertions
```java
SoftAssert soft = new SoftAssert();
soft.assertEquals(user.getName(), "Alice");
soft.assertEquals(user.getAge(), 25);
soft.assertTrue(user.isActive());
soft.assertAll(); // Reports all failures at once
```
### Listeners
```java
public class TestListener implements ITestListener {
@Override public void onTestFailure(ITestResult result) {
System.out.println("Failed: " + result.getName());
// Take screenshot, log, etc.
}
}
@Listeners(TestListener.class)
public class LoginTest { /* ... */ }
```
### Lifecycle Annotations
```
@BeforeSuite → @BeforeTest → @BeforeClass → @BeforeMethod → @Test → @AfterMethod → @AfterClass → @AfterTest → @AfterSuite
```
### Anti-Patterns
| Bad | Good | Why |
|-----|------|-----|
| `dependsOnMethods` everywhere | Independent tests | Cascading failures |
| No groups | `@Test(groups = "smoke")` | Can't run subsets |
| Hard-coded test data | `@DataProvider` | Reusable |
| Priority ordering | Independent tests | Fragile |
## Quick Reference
| Task | Command |
|------|---------|
| Run suite | `mvn test -DsuiteXmlFile=testng.xml` |
| Run group | `mvn test -Dgroups=smoke` |
| Run class | `mvn test -Dtest=LoginTest` |
| Reports | `test-output/index.html` |
## Deep Patterns → `reference/playbook.md`
| § | Section | Lines |
|---|---------|-------|
| 1 | Project Setup & Configuration | Maven + Surefire config |
| 2 | Suite XML Configuration | Multi-env, parallel, groups |
| 3 | BaseTest & Thread-Safe Driver | ThreadLocal, ConfigReader |
| 4 | Data Providers (Advanced) | Excel, JSON, CSV, parallel, cross-class |
| 5 | Factory Pattern | Cross-browser matrix |
| 6 | Listeners (Production Suite) | Retry, screenshot, timing |
| 7 | Soft Assertions & Dependencies | Groups, method deps |
| 8 | Page Object Integration | PageFactory, fluent POs |
| 9 | Parallel Execution Strategies | Method/class/test/mixed |
| 10 | Reporting Integration | Allure, ExtentReports |
| 11 | CI/CD Integration | GitHub Actions, Jenkins |
| 12 | Debugging Quick-Reference | 12 common problems |
| 13 | Best Practices Checklist | 14 items |
© TestMu AI · MIT · LambdaTest/agent-skills