bdd-overview
Overview of behavior-driven development for engineers and BAs new to it: maps each role (manual tester, business analyst, developer) to a starting point, explains Gherkin's Given/When/Then structure with a minimal example, and points onward to scenario authoring and review. Use when getting started with BDD.
Install with skills.sh (any agent)
npx skills add testland/qa --skill bdd-overviewbdd-overview
What is BDD and why does it matter?
Behavior Driven Development (BDD) is "a way for software teams to work that closes the gap between business people and technical people" (cucumber.io/docs/bdd). It works through three repeating steps: Discovery (structured conversations around concrete examples), Formulation (writing those examples in an automatable format), and Automation (implementing behavior guided by the resulting tests).
The formulation language is Gherkin - "a set of special keywords to give structure and meaning to executable specifications" (cucumber.io/docs/gherkin/reference). Gherkin files are plain text, readable by everyone on the team, not just developers.
The three roles who collaborate on writing Gherkin are known as the Three Amigos (cucumber.io/docs/bdd/who-does-what):
"These conversations can produce great tests, because each amigo sees the product from a different perspective." (cucumber.io/docs/bdd/who-does-what)
Minimal Gherkin example
Feature: Apply promo code at checkout
Scenario: Valid code reduces subtotal
Given a logged-in user with a cart containing "BOOK-001" at $24.99
When the user applies promo code "WELCOME10"
Then the subtotal is $22.49Per the Gherkin reference (cucumber.io/docs/gherkin/reference):
Steps should stay in business language. Avoid UI mechanics ("clicks button #submit") - a Gherkin style review will flag those.
Which skill to start with?
You are a manual tester migrating scripts to BDD
Start with manual-step-to-gherkin. It translates an existing manual test step (table row, prose bullet, TestRail/Qase export) into declarative Gherkin, stripping UI mechanics and elevating user intent. This is the bridge path from manual test scripts into the BDD workflow without requiring you to know Cucumber or step definitions first.
You are a BA writing acceptance criteria
Start with gherkin-from-stories to convert user stories directly into Gherkin. It extracts the actor/capability/value triple from "As a... I want... so that..." stories, maps each acceptance criterion to a Scenario block, and flags axes suitable for Scenario Outlines. Alternatively, if your team practices ATDD and you work from acceptance criteria rather than full stories, use acceptance-test-from-criteria to generate executable tests that map back to individual ACs.
You have Gherkin and need step definitions wired to your runner
Scaffold step definitions for whichever runner is detected in your project: Cucumber (JVM/JS/Ruby), Behave (Python), or Reqnroll (.NET). Once you know your runner, the dedicated skill provides full install and run guidance: cucumber-testing, behave-testing, or reqnroll-testing.
You have written Feature files and want a quality check
Review your Feature files for imperative steps, technical leakage (DB names, CSS selectors), excessive And-chains, missing Background extraction, and Then-clauses with no observable outcome. Do this during PR review against any *.feature file.
Hard rejects
This skill does not scaffold step definitions or run any test framework. Invoke it only to orient yourself - then proceed to the skill or agent that matches your role above. Do not use this skill as a substitute for a runner skill (cucumber-testing, behave-testing, reqnroll-testing).