Bdd Patterns

Teaches Claude to write BDD specs using Given-When-Then patterns and Gherkin syntax. You'll get proper feature file organization, scenario outlines for data-driven tests, and step definition patterns that bridge business requirements with test code. The source includes solid examples of shopping carts, authentication flows, and password validation. Honestly, this is most useful when you need non-technical stakeholders to read your tests or when you're trying to write acceptance criteria before diving into implementation. The patterns push you toward declarative scenarios over implementation details, which is the whole point of BDD but also requires discipline to maintain as your codebase evolves.

skills.sh installs: 208
GitHub stars: 200
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thebushidocollective/han --skill bdd-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

BDD Patterns

Master Behavior-Driven Development patterns to write clear, business-readable specifications that drive implementation.

Given-When-Then Structure

The fundamental BDD pattern uses three parts:

Given: The initial context or preconditions
When: The action or event being tested
Then: The expected outcome or result

Feature: User Authentication

  Scenario: Successful login with valid credentials
    Given a registered user with email "user@example.com"
    And the user has password "secure123"
    When the user submits the login form with correct credentials
    Then the user should be redirected to the dashboard
    And a session should be created

Feature File Organization

Feature: Shopping Cart
  As a customer
  I want to manage items in my cart
  So that I can purchase products I'm interested in

  Background:
    Given I am logged in as a customer
    And the product catalog is available

  Scenario: Add item to empty cart
    Given my cart is empty
    When I add "Blue T-Shirt" to my cart
    Then my cart should contain 1 item
    And the cart total should be $29.99

SKILL.md on GitHub