Skip to main content
skill CX Codex

gauge-skill — Claude Code skill: what it does, how to install

Generates Gauge Markdown test specifications and step implementations in Java, Python, JavaScript, or Ruby.

MIT 218 installs ★ 393 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add LambdaTest/agent-skills --skill gauge-skill -a claude-code
Open on GitHub

What gauge-skill does

This skill guides coding agents through ThoughtWorks Gauge test automation. It creates Markdown scenario files (.spec), parameter tables, and reusable concept definitions (.cpt). Along with specs, it provides step implementations using @Step decorators in Java, Python, JavaScript, Ruby, and C#.

The reference patterns include Page Object classes, ScenarioDataStore handling, and execution hooks. For cloud runs via LambdaTest, the execution requires LT_USERNAME and LT_ACCESS_KEY environment variables.

What it helps with

  • write Gauge Markdown specification files with scenarios and data tables
  • generate step implementations in Java or Python using Selenium
  • group repetitive test steps into reusable .cpt concept files
  • configure remote WebDriver runs with LambdaTest cloud options

Example prompts for the agent

  • Create a Gauge specification specs/login.spec for user login scenarios
  • Generate Python step implementations with Selenium for the login spec
  • Build a reusable concept file specs/concepts/login.cpt for authentication steps

How to install gauge-skill

1Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill gauge-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/gauge-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gauge-skill/

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

Questions about gauge-skill

How to install gauge-skill in Claude Code?

Run npx skills add LambdaTest/agent-skills --skill gauge-skill -a claude-code.

What does gauge-skill do?

It helps agents write Markdown test specifications for the Gauge framework and generate matching step definitions in multiple languages.

Which programming languages are supported?

The skill supports Java, Python, JavaScript, Ruby, and C#.

Source text

SKILL.md · MIT
---
name: gauge-skill
description: >
  Generates Gauge test specifications in Markdown with step implementations
  in Java, Python, JS, or Ruby. ThoughtWorks' test automation framework.
  Use when user mentions "Gauge", "spec file", "## Scenario", "step
  implementation". Triggers on: "Gauge", "Gauge spec", "Gauge framework",
  "ThoughtWorks test".
languages:
  - Java
  - Python
  - JavaScript
  - Ruby
  - C#
category: bdd-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Gauge Automation Skill

## Core Patterns

### Specification (specs/login.spec)

```markdown
# Login Feature

## Successful Login
* Navigate to login page
* Enter email "[email protected]"
* Enter password "password123"
* Click login button
* Verify dashboard is displayed
* Verify welcome message contains "Welcome"

## Invalid Credentials
* Navigate to login page
* Enter email "[email protected]"
* Enter password "wrong"
* Click login button
* Verify error message "Invalid credentials" is shown

## Login with multiple users
|email             |password |expected  |
|-----------------|---------|----------|
|[email protected]   |admin123 |Dashboard |
|[email protected]    |pass123  |Dashboard |
|[email protected]     |wrong    |Error     |

* Login as <email> with <password>
* Verify <expected> page is shown
```

### Step Implementation — Java

```java
import com.thoughtworks.gauge.Step;
import com.thoughtworks.gauge.Table;

public class LoginSteps {
    WebDriver driver;

    @Step("Navigate to login page")
    public void navigateToLogin() {
        driver.get("http://localhost:3000/login");
    }

    @Step("Enter email <email>")
    public void enterEmail(String email) {
        driver.findElement(By.id("email")).sendKeys(email);
    }

    @Step("Enter password <password>")
    public void enterPassword(String password) {
        driver.findElement(By.id("password")).sendKeys(password);
    }

    @Step("Click login button")
    public void clickLogin() {
        driver.findElement(By.cssSelector("button[type='submit']")).click();
    }

    @Step("Verify dashboard is displayed")
    public void verifyDashboard() {
        assertTrue(driver.getCurrentUrl().contains("/dashboard"));
    }
}
```

### Step Implementation — Python

```python
from getgauge.python import step
from selenium import webdriver

@step("Navigate to login page")
def navigate_to_login():
    driver.get("http://localhost:3000/login")

@step("Enter email <email>")
def enter_email(email):
    driver.find_element_by_id("email").send_keys(email)

@step("Click login button")
def click_login():
    driver.find_element_by_css_selector("button[type='submit']").click()
```

### Concepts (Reusable Step Groups — specs/concepts/login.cpt)

```markdown
# Login as <email> with <password>
* Navigate to login page
* Enter email <email>
* Enter password <password>
* Click login button
```

## Setup: `gauge install java` (or `python`, `js`, `ruby`)
## Init: `gauge init java`
## Run: `gauge run specs/` or `gauge run specs/login.spec`

### Cloud Execution on TestMu AI

Set environment variables: `LT_USERNAME`, `LT_ACCESS_KEY`

```java
// StepImplementation.java
ChromeOptions browserOptions = new ChromeOptions();
HashMap<String, Object> ltOptions = new HashMap<>();
ltOptions.put("user", System.getenv("LT_USERNAME"));
ltOptions.put("accessKey", System.getenv("LT_ACCESS_KEY"));
ltOptions.put("build", "Gauge Build");
ltOptions.put("platformName", "Windows 11");
ltOptions.put("video", true);
ltOptions.put("console", true);
browserOptions.setCapability("LT:Options", ltOptions);
Driver.setWebDriver(new RemoteWebDriver(
    new URL("https://hub.lambdatest.com/wd/hub"), browserOptions));
```
## Tags: `gauge run --tags "smoke"` (use `Tags: smoke` in spec)

## Deep Patterns

See `reference/playbook.md` for production-grade patterns:

| Section | What You Get |
|---------|-------------|
| §1 Project Setup | Installation, project structure, environment properties |
| §2 Spec Files | Markdown scenarios, data tables, concepts (.cpt) |
| §3 Step Implementations | Java steps, table-driven steps, assertions |
| §4 Hooks & Execution | BeforeSuite/Scenario/Step, screenshots, browser logs |
| §5 Page Objects | BasePage, concrete pages, usage in steps |
| §6 Data Management | ScenarioDataStore, SpecDataStore, CSV data |
| §7 LambdaTest Integration | Remote driver factory with LT:Options |
| §8 CI/CD Integration | GitHub Actions with parallel execution, XML reports |
| §9 Debugging Table | 12 common problems with causes and fixes |
| §10 Best Practices | 14-item Gauge testing checklist |

© TestMu AI · MIT · LambdaTest/agent-skills

Similar skills

All skills for Testing and QA →

From the same set47

The whole set →
xunit-skill Gives the coding agent a working pattern for xUnit.net in C#: which attribute to use, how to share fixtures, what to assert. Useful when tests need to match xUnit conventions. CX Codex +1 224installs specflow-skill Drafts SpecFlow BDD suites for C#/.NET: Gherkin feature files plus the step bindings behind them. Useful when a project already runs on NUnit or xUnit. CX Codex +1 223installs serenity-bdd-skill serenity-bdd-skill is a Claude Code skill that creates Java BDD tests with Serenity and the Screenplay pattern. It activates for requests about Serenity, @Steps, or Serenity reports. CX Codex +1 223installs rspec-skill Generates RSpec tests in Ruby with describe/context/it blocks, matchers, let/before hooks, and mocking. Works with Claude Code, Codex, Cursor, GitHub Copilot, and other editors. CX Codex +1 222installs behat-skill Generates Behat BDD tests for PHP with Gherkin scenarios and MinkContext for browser checks. Creates feature files, custom contexts and behat.yml config. CX Codex +1 216installs testunit-skill testunit-skill generates Test::Unit tests for Ruby projects: xUnit-style classes, assert methods and fixtures. Fits codebases already running on test-unit rather than RSpec. CX Codex +1 213installs testcafe-skill Generate TestCafe end-to-end tests in JavaScript or TypeScript, from login flows to selector checks. The skill covers local runs and TestMu AI Cloud. CX Codex +1 212installs geb-skill This skill generates browser automation tests in Groovy using Geb and Spock. It provides page object patterns and jQuery-like selectors for e2e testing. CX Codex +1 211installs

Project sponsors

Companies that keep this analytics open