write-feature-spec

Generate Gherkin feature files and pytest-bdd step definitions from natural-language prompts.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/claude-marketplace --skill write-feature-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-feature-spec
Source: https://github.com/hpsgd/claude-marketplace/tree/main/plugins/engineering/python-developer/skills/write-feature-spec
Command: npx skills add https://github.com/hpsgd/claude-marketplace --skill write-feature-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing robust BDD-based specifications can be tedious and error-prone; this Skill automates the creation of feature files and step definitions from natural-language prompts, ensuring consistency and test coverage.

Core Features & Use Cases

  • Generates Gherkin Feature files from user prompts, including Background, Scenarios, and Examples.
  • Produces corresponding pytest-bdd style step definitions scaffolding and conftest reuse patterns.
  • Validates structure rules and helps surface edge cases, error scenarios, and parameterization templates for multiple inputs.

Quick Start

Provide a business goal as input and generate a complete Gherkin feature file with corresponding step definitions.

Frequently Asked Questions about write-feature-spec

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

FAQPage Schema
How do I generate Gherkin feature files from natural language requirements?

To generate Gherkin feature files from natural language, provide a business goal prompt to automate BDD spec creation. This process outputs structured feature files containing Background, Scenarios, and Examples sections for pytest-bdd.

How do I scaffold pytest-bdd step definitions and conftest reuse patterns?

Scaffolding pytest-bdd step definitions requires translating Gherkin steps from feature files into Python code. This generates conftest files, reusable steps, and factory templates to bind scenario text to executable test functions.

What is the best way to cover edge cases and error scenarios in BDD testing?

The best way to cover edge cases in BDD testing is generating parameterized scenarios using Gherkin Examples sections. This expands inputs across happy-path, edge-case, and error scenarios to validate Python codebases comprehensively.

Does pytest-bdd support Background and Scenario Outline structures for Python projects?

pytest-bdd supports Background and Scenario Outline structures for Python projects by enforcing mandatory Gherkin syntax rules. It parses these sections to share common step contexts and drive data-driven test execution.

Can I automate BDD test coverage directly from business goals without manual Gherkin syntax?

You can automate BDD test coverage directly from business goals by processing natural-language prompts into ready-to-use Gherkin syntax. This eliminates manual formatting errors and ensures consistent structured test generation.