bdd-author

Generate Gherkin feature files and step definition stubs from issues.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/ubiquitousthey/exo --skill bdd-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-author
Source: https://github.com/ubiquitousthey/exo/tree/main/skills/bdd-author
Command: npx skills add https://github.com/ubiquitousthey/exo --skill bdd-author

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes the manual, error-prone work of turning issue requirements into executable BDD feature files and corresponding step definitions, ensuring tests are traceable to requirements and issues.

Core Features & Use Cases

  • Feature generation from issues: Parse issue title and body to produce Gherkin .feature files with scenarios and traceability tags.
  • Step-definition scaffolding: Extract unique Given/When/Then steps from feature files, detect framework conventions, and generate step definition stubs with TODOs while avoiding duplicates.
  • Framework detection and guidance: Detect or infer the project's BDD framework and test directory, preserve @REQ-XXX, @issue-N, and @AC-N tags, and advise on missing dependencies.
  • Use case: Convert a GitHub issue with acceptance criteria into a traceable feature file and scaffold the initial step definitions to accelerate test automation.

Quick Start

Run the bdd-author write action with an issue title and body to create a Gherkin feature file, then run bdd-author automate for that feature file to scaffold step definitions.

Frequently Asked Questions about bdd-author

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

FAQPage Schema
How do I generate Gherkin feature files from GitHub issues?

You can generate Gherkin feature files from GitHub issues by parsing the issue title and body to create scenarios with traceability tags like @REQ-XXX and @issue-N, ensuring tests remain traceable to original requirements. This automates converting acceptance criteria into executable feature files.

Can I scaffold BDD step definitions across Python, JavaScript, and Ruby projects?

Yes, you can scaffold BDD step definitions across Python, JavaScript/TypeScript, Ruby, Go, and JVM languages by detecting framework conventions and generating unique Given/When/Then step stubs with TODOs, avoiding duplicate definitions across the project's test directory.

How does traceability tagging work when creating BDD feature files from issues?

Traceability tagging preserves @REQ-XXX, @issue-N, and @AC-N tags within generated Gherkin feature files to maintain a direct link between acceptance criteria in issues and the executed test scenarios, ensuring full requirements coverage visibility throughout the test automation lifecycle.

What is the best way to avoid duplicate step definitions in BDD test automation?

The best way to avoid duplicate step definitions in BDD test automation is to extract unique Given/When/Then steps from existing feature files and check against current project definitions before generating framework-appropriate stubs, ensuring no redundant test code is introduced.

How do I detect the correct BDD framework and test directory in my repository?

Framework detection scans the software repository to identify the active BDD framework and locate the appropriate test directory, inferring conventions from dependencies and file structures to place generated step definitions and feature files correctly within the project.

What happens if my project is missing BDD framework dependencies?

If your project is missing BDD framework dependencies, the system reports the absent packages and provides specific installation guidance, ensuring the generated step definitions and feature files can execute immediately within the detected language environment without manual troubleshooting.