acceptance-criteria-generator

Convert plain-English requirements into structured Given/When/Then acceptance criteria.

7|1|Updated Oct 16, 2025
One-click install
npx skills add https://github.com/xloxn69/AgileFlow --skill acceptance-criteria-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-criteria-generator
Source: https://github.com/xloxn69/AgileFlow/tree/main/skills/acceptance-criteria-generator
Command: npx skills add https://github.com/xloxn69/AgileFlow --skill acceptance-criteria-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vague or poorly structured requirements lead to misunderstandings, rework, and difficulty in testing. This skill ensures clarity and testability from the start of development.

Core Features & Use Cases

  • Given/When/Then Formatting: Converts plain English requirements into structured, testable Given/When/Then acceptance criteria.
  • Testable & Independent: Ensures each criterion is specific, independent, clear, and measurable, ready for development.
  • Use Case: You're defining a user story for a login feature. This skill takes your description ("User should be able to log in with email and password") and generates precise AC for successful login and invalid credentials, making the story ready for development.

Quick Start

Use the acceptance-criteria-generator skill to create AC for "a user can reset their password via email".

Frequently Asked Questions about acceptance-criteria-generator

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

FAQPage Schema
How do I convert user story requirements into acceptance criteria?

Acceptance criteria convert plain-English requirements into structured Given/When/Then format, ensuring each criterion is specific, measurable, and testable in isolation. This approach clarifies what success looks like before development begins.

What is the Given/When/Then format and why use it for acceptance criteria?

Given/When/Then is a structured format that specifies preconditions, actions, and expected outcomes for each acceptance criterion. It eliminates ambiguity, makes criteria independently testable, and aligns requirements with test cases.

How many acceptance criteria should I generate per user story?

Generate 2–5 acceptance criteria per user story to cover functional and technical requirements without overwhelming the story. Each criterion remains independent and focused on a single testable scenario.

Can acceptance criteria help reduce rework and misunderstandings?

Yes. Clear, structured acceptance criteria prevent vague requirements from causing misunderstandings and rework during development. They establish measurable, unambiguous expectations upfront, ready for validation by QA and developers.

What types of requirements work best with acceptance criteria?

Acceptance criteria work best for agile user stories defining features or user interactions—login flows, password resets, form submissions, or any scenario with clear inputs, actions, and verifiable outcomes.