write-acceptance-criteria

Write Given/When/Then acceptance criteria for user stories.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/turtlestack --skill write-acceptance-criteria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-acceptance-criteria
Source: https://github.com/hpsgd/turtlestack/tree/main/plugins/engineering/qa-lead/skills/write-acceptance-criteria
Command: npx skills add https://github.com/hpsgd/turtlestack --skill write-acceptance-criteria

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams, developers, and QA collaboratively define robust, testable acceptance criteria for user stories using a structured discovery process aligned with Example Mapping and Given/When/Then.

Core Features & Use Cases

  • Guided discovery steps to understand a story, identify actors, goals, value, context, and scope.
  • Systematic rules extraction to capture business constraints, permissions, and edge cases.
  • Scenario writing using Given/When/Then for each rule, including happy paths, validation errors, permission checks, edge cases, and concurrency when applicable.
  • Non-functional criteria definition (performance, accessibility, security, resilience) and mapping to test levels (unit, integration, e2e).
  • INVEST-aligned review workflow with explicit open questions and out-of-scope notes.
  • Output of a standardized acceptance criteria document ready for product, dev, and QA alignment.

Quick Start

Provide a user story to define, and this skill will generate a complete acceptance criteria specification.

Frequently Asked Questions about write-acceptance-criteria

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

FAQPage Schema
How do I write testable acceptance criteria for a user story?

Acceptance criteria are best written by enforcing discovery to identify actors and scope, extracting business rules, and structuring them into Given/When/Then scenarios. This ensures criteria are unambiguous and testable across unit, integration, and e2e levels.

What is the best way to capture edge cases and business rules in acceptance criteria?

Capturing edge cases requires systematic rules extraction to identify business constraints and permissions. These rules are then documented as Given/When/Then scenarios, explicitly covering validation errors, permission checks, and concurrency to ensure unambiguous testable criteria.

How do I structure acceptance criteria using Given/When/Then format?

Structuring acceptance criteria with Given/When/Then involves writing scenarios for each business rule. You map happy paths, validation errors, and edge cases to test levels, producing a standardized document that aligns product, dev, and QA teams before development.

When do I need to include non-functional criteria in my user story?

Non-functional criteria are needed to define performance, accessibility, security, and resilience constraints. They are mapped to appropriate test levels like unit, integration, or e2e, ensuring the user story meets all system requirements and producing a complete acceptance criteria document.

Can I use Example Mapping to define INVEST-compliant backlog items?

Yes, Example Mapping supports backlog refinement by extracting rules and discovering scenarios, which naturally aligns with an INVEST-style review. This workflow enforces scope identification and surfaces open questions, ensuring backlog items are testable and well-defined.