BDD from API Spec

Generate Gherkin BDD feature files and Go/Godog step stubs from API handler definitions.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/cdalsoniii/brightpath-coder --skill bdd-from-api-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: BDD from API Spec
Source: https://github.com/cdalsoniii/brightpath-coder/tree/main/.cursor/skills/bdd-from-api-spec
Command: npx skills add https://github.com/cdalsoniii/brightpath-coder --skill bdd-from-api-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of Gherkin BDD feature files from API handler definitions, ensuring your API endpoints are covered by executable business specifications.

Core Features & Use Cases

  • Automated Feature File Generation: Creates .feature files for happy paths, error cases, and business rule violations.
  • Step Definition Stubs: Generates Go/Godog format stubs for easy integration.
  • Use Case: When a new API endpoint is added or modified, this Skill can automatically generate the corresponding BDD tests, significantly speeding up the testing process and improving coverage.

Quick Start

Use the bdd-from-api-spec skill to generate BDD feature files for the handler files in the 'api/v1/users' directory.

Frequently Asked Questions about BDD from API Spec

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

FAQPage Schema
How do I generate Gherkin BDD tests from API handler files?

To generate Gherkin BDD tests from API handler files, parse your handler definitions to extract endpoints and map them to executable business scenarios. This process creates .feature files covering happy paths, authentication, authorization, and validation rules.

Can I generate Go Godog step definitions from an API specification?

Yes, you can generate Go Godog step definitions from API specifications. The generation process creates step definition stubs in Go/Godog format, providing executable business specifications that map directly to your API endpoints for immediate integration.

What is the best way to automate BDD feature file creation for new API endpoints?

Automating BDD feature file creation for new API endpoints involves parsing handler files to extract endpoint definitions and mapping them to Gherkin scenarios. This approach ensures consistent coverage of happy paths, error cases, and business rule violations.

Does BDD from API Spec require parsing Go handler files for endpoint extraction?

Yes, BDD from API Spec requires parsing Go handler files for endpoint extraction. The tool analyzes your API handler definitions to identify endpoints and automatically generates corresponding Gherkin BDD feature files and step definition stubs.

What API test scenarios are covered when generating BDD feature files from handler definitions?

Generating BDD feature files from handler definitions covers multiple API test scenarios including happy paths, authentication failures, authorization errors, validation issues, and business rule violations. This ensures comprehensive executable business specifications for your endpoints.

Are there limitations when generating Gherkin scenarios from API handler definitions?

A key limitation when generating Gherkin scenarios from API handler definitions is that the tool currently supports Go/Godog step definitions and requires parseable handler files for endpoint extraction. It may not cover highly custom or complex business logic without manual refinement.