bdd-practices

Guide BDD teams in writing Gherkin across discovery, formulation, and automation phases.

10|7|Updated Jan 5, 2026

Search Tags:#anti-patterns #scenarios #bdd #gherkin #example-mapping #discovery-workshop #bdd-guidance

Ready to run

npx skills add https://github.com/cuongtl1992/vibe-skills --skill bdd-practices-cuongtl1992

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bdd-practices
Source: https://github.com/cuongtl1992/vibe-skills/tree/main/skills/common/bdd-practices
Command: npx skills add https://github.com/cuongtl1992/vibe-skills --skill bdd-practices-cuongtl1992

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps teams craft high-quality Gherkin by providing BDD best-practice guidance, review methods, and practical patterns for discovery and automation.

Core Features & Use Cases

Guidance for Discovery, Formulation, and Automation phases of BDD.
Anti-patterns, checklists, and templates to improve Gherkin quality and consistency.
Use cases include reviewing .feature files, guiding discovery workshops, and transforming imperative tests into declarative scenarios.

Quick Start

Rewrite a sample Gherkin scenario to follow declarative Given-When-Then style using the provided guidance.

Frequently Asked Questions about bdd-practices

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

FAQPage Schema

What are common Gherkin anti-patterns when writing BDD scenarios?▼

Common Gherkin anti-patterns include imperative step sequences and leaking implementation details into scenarios. This Skill identifies these anti-patterns and provides guidance to transform them into declarative Given-When-Then structures.

How do I run an effective BDD discovery workshop using example mapping?▼

To run an effective BDD discovery workshop, you use example mapping to explore scenarios using structured guidance. This Skill provides best-practice methods to facilitate discovery workshops and extract clear rules and examples for Formulation.

How do I convert imperative tests into declarative Gherkin scenarios?▼

You convert imperative tests into declarative Gherkin scenarios by applying provided best-practice guidance and templates. This Skill reviews your .feature files and restructures step sequences to focus on business intent rather than UI interactions.

What is the best way to review .feature files for BDD consistency?▼

The best way to review .feature files for BDD consistency is applying structured checklists and anti-pattern detection. This Skill offers review methods and reference materials to validate scenario outlines and ensure high-quality Gherkin across Discovery and Automation phases.

Does this BDD guidance cover the automation phase or just scenario formulation?▼

This BDD guidance covers the automation phase as well as Discovery and Formulation. It provides structured methods to ensure your automated scenario outlines and .feature files maintain high quality and consistency throughout the entire BDD lifecycle.

When should I use scenario outlines instead of standard Gherkin scenarios?▼

You should use scenario outlines instead of standard scenarios when validating multiple data combinations. This Skill provides scenario outline checks to ensure your examples are structured correctly without introducing Gherkin anti-patterns.