bdd

Guides Behavior-Driven Development from discovery conversations to Gherkin scenarios and pytest-bdd or behave automation.

9|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Yassimba/loom --skill bdd-yassimba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd
Source: https://github.com/Yassimba/loom/tree/main/skills/bdd
Command: npx skills add https://github.com/Yassimba/loom --skill bdd-yassimba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytest-bdd, behave, and includes references (resource) components.

What problem does it solve? Teams often write tests that encode implementation details instead of business behavior, or jump straight to test automation without agreeing on what the software should do. This Skill enforces the BDD order—conversation first, capture second, automation last—so scenarios become executable specifications written in business language. ## Core Features & Use Cases - Structured Discovery: Uses Three Amigos perspectives and Example Mapping to collect rules, concrete examples, and open questions before any test code exists. - Gherkin Quality Gate: Every scenario must pass a six-point gate covering observable behavior, domain language, concreteness, clean Given/When/Then semantics, independence, and wording discipline. - Dual Automation Layers: Bundled references for pytest-bdd (scenarios inside an existing pytest suite) and behave (standalone feature files owned by non-developers), with red-to-green loop guidance and troubleshooting. - Use Case: A developer picking up a billing story asks the agent to define acceptance criteria; the agent simulates the Three Amigos, drafts Gherkin scenarios like "Transfer within the daily limit", gets user approval, then wires pytest-bdd step definitions and watches them fail before implementing. ## Quick Start Use the bdd skill to define acceptance criteria as Gherkin scenarios for the password reset story, then wire them with pytest-bdd.

Frequently Asked Questions about bdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write good Gherkin scenarios for acceptance criteria?

Write each scenario as Given context, one When event, and a Then asserting an observable outcome, using domain language with real names, amounts, and dates. Keep scenarios to 3-5 steps, independent of each other, and free of URLs, selectors, or class names.

Should I use pytest-bdd or behave for BDD in Python?

Choose based on who writes the Gherkin. If developers write it and domain experts review, use pytest-bdd so scenarios run inside the existing pytest suite. If the business writes feature files themselves, use behave, where feature files are the standalone entry point.

Why does pytest-bdd run zero tests for my feature file?

A .feature file with no binding silently runs zero tests in pytest-bdd. You must bind scenarios with scenarios() or @scenario in a test module, then confirm the collected test count grew with pytest --collect-only -q.

Why does behave report my step as undefined?

An undefined step usually means a matcher mismatch: a typo in the step text or placeholder, the wrong keyword decorator, or a use_step_matcher switch earlier in the file. Steps must also live under features/steps/ to be loaded.

When should I not write Gherkin tests?

Skip Gherkin when the behavior is scaffolding, framework glue, or an implementation still finding its shape. If a scenario reads as a natural-language translation of a technical test, rewrite it in business terms or use a plain pytest test instead.