amey-thakur/ai-skills/bdd-scenarios
Claude Code and agent skill by amey-thakur/ai-skills
- community
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-scenariosSKILL.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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
.featurefile 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
- SKILL.md in the repositoryCheckingskills/testing/bdd-scenarios/SKILL.md
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
[](https://verified-skill.com/skills/amey-thakur/ai-skills/bdd-scenarios)