Back to Skills

cucumber-step-definitions

verified

Writing effective step definitions and organizing test code

View on GitHub

Marketplace

han

TheBushidoCollective/han

Plugin

jutsu-cucumber

Technique

Repository

TheBushidoCollective/han
60stars

jutsu/jutsu-cucumber/skills/cucumber-step-definitions/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/TheBushidoCollective/han/blob/main/jutsu/jutsu-cucumber/skills/cucumber-step-definitions/SKILL.md -a claude-code --skill cucumber-step-definitions

Installation paths:

Claude
.claude/skills/cucumber-step-definitions/
Powered by add-skill CLI

Instructions

# Cucumber Step Definitions

Master writing maintainable and reusable step definitions for Cucumber tests.

## Basic Step Definitions

Define steps that match Gherkin syntax:

### JavaScript/TypeScript (Cucumber.js)

```javascript
const { Given, When, Then } = require('@cucumber/cucumber');

Given('I am on the login page', async function() {
  await this.page.goto('/login');
});

When('I enter valid credentials', async function() {
  await this.page.fill('#username', 'testuser');
  await this.page.fill('#password', 'password123');
});

Then('I should be logged in', async function() {
  const welcomeMessage = await this.page.textContent('.welcome');
  expect(welcomeMessage).toContain('Welcome, testuser');
});
```

### Java (Cucumber-JVM)

```java
import io.cucumber.java.en.*;
import static org.junit.Assert.*;

public class LoginSteps {

  @Given("I am on the login page")
  public void i_am_on_login_page() {
    driver.get("http://example.com/login");
  }

  @When("I enter valid credentials")
  public void i_enter_valid_credentials() {
    driver.findElement(By.id("username")).sendKeys("testuser");
    driver.findElement(By.id("password")).sendKeys("password123");
  }

  @Then("I should be logged in")
  public void i_should_be_logged_in() {
    String welcome = driver.findElement(By.className("welcome")).getText();
    assertTrue(welcome.contains("Welcome, testuser"));
  }
}
```

### Ruby

```ruby
Given('I am on the login page') do
  visit '/login'
end

When('I enter valid credentials') do
  fill_in 'username', with: 'testuser'
  fill_in 'password', with: 'password123'
end

Then('I should be logged in') do
  expect(page).to have_content('Welcome, testuser')
end
```

## Parameterized Steps

Capture values from Gherkin steps:

```javascript
// Scenario: I search for "Cucumber" in the search bar

When('I search for {string} in the search bar', async function(searchTerm) {
  await this.page.fill('#search', searchTerm);
  await this.page.click('#search-button');
});

// Sc

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
8089 chars