amey-thakur/ai-skills/bdd-scenarios

Claude Code and agent skill by amey-thakur/ai-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Write given-when-then scenarios in domain language so stakeholders can read and confirm the behavior each test protects. Use when drafting acceptance criteria or Gherkin features for a user-facing rule.

Install

npx vskill@latest install amey-thakur/ai-skills/bdd-scenarios

SKILL.md

The same SKILL.md was published earlier as amey-thakur/ai-skills/bdd-scenarios.

BDD scenarios

Behavior-driven development (BDD) scenarios earn their keep only when a product owner reads one and agrees it describes the intended behavior. Padded with UI clicks or written in code-speak, they become slow tests that nobody outside engineering trusts. The whole discipline is keeping each scenario in the language of the business, not the implementation.

Method

  1. One scenario, one rule. A scenario names a single behavior:

Applying an expired coupon leaves the price unchanged. If the title needs "and" to be honest, split it. Twelve tight scenarios read better than three that each test four things.

  1. Given sets state, When is one action, Then is the observable result.

Given is prior facts (Given a cart totaling $80), When is the single trigger under test (When the customer applies coupon SAVE10), Then is what a user or the system can see (Then the total is $72). Never put an action in Given or a second When before the Then.

  1. Speak the domain, not the DOM. Write `When the customer submits the

order, not When I click #submit-btn`. Selectors and keystrokes belong in the step definitions, hidden from the reader. A scenario tied to markup breaks on a redesign that changed no behavior.

  1. Push the value matrix into Scenario Outline. One outline with an

Examples table covers SAVE10, SAVE20, and an expired code in three rows instead of three near-identical scenarios. Keep each row a distinct rule, not just a distinct number.

  1. Keep Background to shared facts only. Background runs before every

scenario in the file, so it holds setup common to all of them and nothing scenario-specific. If a Given appears in every scenario, promote it; if it appears in two, leave it inline.

  1. Bind steps to intent in the step layer. With Cucumber, Behave,

pytest-bdd, or SpecFlow, one step phrase maps to one function. Reuse phrases so the vocabulary stays small and the glue code stays shared.

Litmus tests

  • Can a non-engineer read the .feature file aloud and say whether it

matches the intended rule?

  • Does every Then assert something a user or downstream system observes,

never an internal call or private field?

  • If the UI were rebuilt with new markup, would the scenarios survive

untouched while only step definitions changed?

Boundaries

BDD is for behavior stakeholders care about, not for exhaustive edge cases: push the empty, boundary, and malformed-input matrix down to unit tests where it stays fast and cheap. Follow the team's existing feature-file layout and tag scheme over the structure shown here.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
10
Repository forks
2
7-day trend score
17

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/amey-thakur/ai-skills/bdd-scenarios/badge)](https://verified-skill.com/skills/amey-thakur/ai-skills/bdd-scenarios)

Something wrong with this skill or its page? Tell us.