← ClaudeAtlas

plan-writing-gherkin-criterialisted

Guide for writing Gherkin acceptance criteria using Given-When-Then syntax for testable requirements. Covers scenario structure, background blocks, scenario outlines with examples tables, common patterns for authentication/CRUD/validation/error handling, and best practices for clear testable specifications. Essential for writing user stories and plan acceptance criteria
wahidyankf/ose-primer · ★ 2 · Web & Frontend · score 75
Install: claude install-skill wahidyankf/ose-primer
# Gherkin Acceptance Criteria Skill ## Purpose This Skill provides comprehensive guidance for writing **Gherkin acceptance criteria** using Given-When-Then syntax to create clear, testable specifications for features and user stories. **When to use this Skill:** - Writing acceptance criteria for user stories - Defining testable requirements in plans - Specifying expected behavior for features - Creating scenarios for validation testing - Documenting edge cases and error handling - Communicating requirements to developers and testers ## Core Concepts ### What is Gherkin? **Gherkin** is a structured language for writing acceptance criteria using Given-When-Then syntax. It enables: - **Clear communication**: Non-technical stakeholders understand requirements - **Testable specifications**: Scenarios map directly to automated tests - **Complete coverage**: All scenarios and edge cases documented - **Unambiguous expectations**: No room for interpretation ### Given-When-Then Structure **Anatomy of a scenario**: ```gherkin Scenario: [Brief description of scenario] Given [Initial context/preconditions] When [Action or event occurs] Then [Expected outcome/postconditions] ``` **Breakdown**: - **Given**: Sets up the context (initial state, preconditions, setup) - **When**: Describes the action or event (user action, system event, trigger) - **Then**: Specifies expected outcome (assertions, verification, results) **Example**: ```gherkin Scenario: User logs in with val