acceptance-test-writing

Generate acceptance criteria and Gherkin Given-When-Then scenarios for user stories.

1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/vinceh/recipe --skill acceptance-test-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-test-writing
Source: https://github.com/vinceh/recipe/tree/main/.claude/skills/acceptance-test-writing
Command: npx skills add https://github.com/vinceh/recipe --skill acceptance-test-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Guides writing acceptance criteria and tests using industry-standard BDD (Behavior-Driven Development) and ATDD (Acceptance Test-Driven Development) practices. This skill guides the creation of clear, testable acceptance criteria using Gherkin syntax and best practices.

Core Features & Use Cases

  • Decision frameworks: Given-When-Then and Rule-Oriented formats.
  • Writing from a user perspective with measurable outcomes.
  • Quick Start: craft a basic Given-When-Then scenario for a user story.

Quick Start

Write acceptance criteria for a user story: As a customer I want to filter products by price range; choose Given-When-Then structure to describe scenarios.

Frequently Asked Questions about acceptance-test-writing

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

FAQPage Schema
How do I write acceptance criteria using Given-When-Then format?

Given-When-Then is a structured format for acceptance criteria: Given describes the initial state, When specifies the user action, and Then defines the expected outcome. Write each scenario with one trigger per When clause using domain language and measurable results, avoiding implementation details.

What's the difference between BDD and ATDD for acceptance testing?

BDD (Behavior-Driven Development) and ATDD (Acceptance Test-Driven Development) both use Gherkin syntax and Given-When-Then scenarios. BDD emphasizes collaboration and shared language across teams; ATDD focuses on writing tests before implementation to drive development from acceptance criteria.

Can I use Rule-Oriented format instead of Given-When-Then for acceptance tests?

Yes. Rule-Oriented format structures acceptance criteria as testable business rules rather than scenarios. This format suits checklist-style requirements and is particularly useful when multiple conditions must be validated independently from user workflows.

How do I convert user story requirements into Gherkin syntax?

Extract the user perspective and measurable outcome from the story. Map the user action to When, the preconditions to Given, and the success criteria to Then. Use active voice, domain terminology, and one action per scenario to keep tests maintainable and reusable.

What should I avoid when writing acceptance criteria?

Avoid UI-specific details, implementation-specific language, and multiple triggers in a single When clause. Don't use passive voice or vague outcomes. Focus on functional behavior and testability rather than how the system should build the feature.

Can acceptance criteria serve as both documentation and automated tests?

Yes. Well-written Gherkin scenarios and Rule-Oriented criteria act as living documentation and can be automated directly in test frameworks. This dual purpose enforces clarity, reduces documentation drift, and aligns stakeholders on expected behavior.