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
npx skills add LambdaTest/agent-skills --skill gauge-skill -a claude-codeWhat 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
.cptconcept files - configure remote WebDriver runs with LambdaTest cloud options
Example prompts for the agent
- Create a Gauge specification
specs/login.specfor user login scenarios - Generate Python step implementations with Selenium for the login spec
- Build a reusable concept file
specs/concepts/login.cptfor authentication steps
How to install gauge-skill
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill gauge-skill -a claude-code2Manually: put the files in place
~/.claude/skills/gauge-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gauge-skill/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill gauge-skill -a codex2Manually: put the files in place
.agents/skills/gauge-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill gauge-skill -a cursor2Manually: put the files in place
.cursor/skills/gauge-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills gauge-skill2Manually: put the files in place
.github/skills/gauge-skill/SKILL.md1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill gauge-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/LambdaTest/agent-skills --path gauge-skillManually: put the files in place
.devin/skills/gauge-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill gauge-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 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