Is this applicable to all Cucumber implementations?

Yes, while the Gherkin language is universal, the skill provides guidance that applies across various Cucumber implementations including Ruby, JavaScript, Java, and Python (Behave).

How does this skill help with Cucumber test maintenance?

It promotes declarative writing and scenario independence, ensuring that tests focus on business logic rather than UI details, which makes them less prone to breaking during implementation changes.

Can Claude help me refactor 'Imperative' tests using this skill?

Yes, the skill provides specific patterns to identify implementation-focused steps (like clicking CSS selectors) and transform them into business-focused steps (like adding a product to a cart).

Does this skill cover data management for tests?

Absolutely. It includes best practices for using factories instead of hardcoded IDs and managing test data to ensure scenarios remain independent and repeatable.

Cucumber Best Practices for Claude Code

Name: Cucumber Best Practices for Claude Code
Author: TheBushidoCollective

byTheBushidoCollective

•

Security & Testing

Guides Claude in writing high-quality, declarative Cucumber scenarios and Gherkin steps that align with professional BDD standards.

This skill empowers Claude to act as an expert Behavior-Driven Development (BDD) consultant, ensuring your Cucumber tests are readable, maintainable, and business-focused. It provides specialized patterns for declarative scenario design, efficient Gherkin syntax, and robust step definition architecture while helping users avoid common anti-patterns like imperative scripting or over-generic steps. Whether you are refactoring legacy tests or building a new automation suite from scratch, this skill ensures your test documentation reflects true business requirements rather than fragile technical implementation details.

Key Features

01Identification and refactoring of common Gherkin anti-patterns

02Scenario independence and background setup optimization

03Reusable step definition patterns and data factory integration

04Tagging strategies for smoke, critical, and parallel testing

0539 GitHub stars

06Declarative Gherkin generation focused on business outcomes

Use Cases

01Generating comprehensive BDD test suites for new features using domain-specific language

02Refactoring imperative, implementation-heavy Cucumber tests into clean, declarative business scenarios

03Reviewing existing feature files to ensure they follow testing pyramid and performance best practices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han cucumber-best-practices

For use in Claude.ai and ChatGPT

Download Skill