define-behavior

Writes behavior-driven Gherkin feature files and scenarios as specification by example.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/azborgonovo/ai-skills --skill define-behavior-azborgonovo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: define-behavior
Source: https://github.com/azborgonovo/ai-skills/tree/main/skills/bdd/define-behavior
Command: npx skills add https://github.com/azborgonovo/ai-skills --skill define-behavior-azborgonovo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning tickets, user stories, or plain-prose requirements into clear, executable Gherkin specifications is hard: scenarios often leak UI or API mechanics, mix multiple behaviors, or assert vague outcomes. This Skill guides the authoring of domain-level .feature files that read as specification by example and survive as living documentation. ## Core Features & Use Cases - Discovery-driven formulation: Maps a work item into rules, examples, and open questions using Example Mapping, and asks clarifying questions instead of guessing requirements. - Domain-level scenario writing: Enforces one behavior per scenario, Given/When/Then mapped to Arrange/Act/Assert, observable outcomes, and concrete realistic data, while stripping selectors, URLs, waits, and SQL from step text. - Structure guidance: Applies Background, Scenario Outline, and data tables only when they earn it, and keeps one shared vocabulary across the feature file. - Use Case: Given a ticket describing discount codes at checkout, produce a discount-codes.feature file with separate scenarios for valid and unknown codes, each with concrete amounts and observable outcomes. ## Quick Start Ask the assistant to turn this user story into Gherkin scenarios for a feature file, keeping steps at the domain level with one behavior per scenario.

Frequently Asked Questions about define-behavior

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

FAQPage Schema
How do I write good Gherkin scenarios from a user story?▼

Map the story into rules, concrete examples, and open questions first, then write one scenario per behavior with Given for context, a single When for the action, and Then for an observable outcome. Ask about anything unclear instead of guessing requirements.

How to keep Gherkin steps at the domain level?▼

Describe what the actor does and what the system does in business terminology, removing selectors, URLs, waits, HTTP verbs, and SQL. Apply the implementation-change test: if the wording must change when the implementation changes, rewrite it in terms of intent.

When should I use Scenario Outline instead of Scenario in Gherkin?▼

Use a Scenario Outline with an Examples table only when one behavior runs with several input variations. When the inputs do not change the behavior, a plain Scenario is clearer and easier to read.

Does this skill work with Cucumber, SpecFlow, or Behave?▼

Yes, the Gherkin it produces is standard .feature file syntax compatible with Cucumber, SpecFlow, and Behave. It covers formulation only; writing the step-definition automation code is a separate concern.

When should I not use this BDD formulation skill?▼

Do not use it to write the automation code behind the steps, which is a separate concern. It is also unnecessary for purely data-driven tests where scenarios drift into unbounded tables rather than describing behavior.