acceptance-criteria

Generate testable acceptance criteria using Given/When/Then or rule-oriented checklists.

9|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/pantheon-org/tekhne --skill acceptance-criteria-pantheon-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-criteria
Source: https://github.com/pantheon-org/tekhne/tree/main/skills/documentation/acceptance-criteria
Command: npx skills add https://github.com/pantheon-org/tekhne --skill acceptance-criteria-pantheon-org

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you define clear, measurable, and testable acceptance criteria for user stories and features, ensuring everyone understands what "done" means and reducing ambiguity.

Core Features & Use Cases

  • Define Measurable Requirements: Craft criteria that can be objectively tested.
  • Apply INVEST Principles: Ensure stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable.
  • Document Scenarios: Include happy paths, negative scenarios, and edge cases.
  • Use Case: When defining requirements for a new user login feature, use this Skill to write criteria like "Given a user enters valid credentials, When they click 'Login', Then they are redirected to the dashboard within 2 seconds."

Quick Start

Use the acceptance-criteria skill to write clear, testable acceptance criteria for the user login feature.

Frequently Asked Questions about acceptance-criteria

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

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

Testable acceptance criteria are generated using structured formats like Given/When/Then or rule-oriented checklists, ensuring requirements are measurable and objectively verifiable. This approach emphasizes INVEST principles to guarantee stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable.

What is the best way to document negative paths and edge cases in acceptance criteria?

Documenting negative paths and edge cases in acceptance criteria involves generating comprehensive scenario coverage alongside happy paths. Structured formats like Given/When/Then help define specific conditions, ensuring measurable outcomes and clear scope definition for both successful and failed feature delivery.

How does INVEST principles apply to writing acceptance criteria?

INVEST principles ensure user stories are Independent, Negotiable, Valuable, Estimable, Small, and Testable. Applying them to acceptance criteria means crafting measurable requirements that objectively define what 'done' means, reducing ambiguity and ensuring stories can be accurately estimated and tested.

When do I need Given/When/Then format for acceptance criteria?

You need Given/When/Then format for acceptance criteria when defining measurable requirements for feature delivery. This structured approach specifies initial conditions, user actions, and expected outcomes, ensuring comprehensive scenario coverage and clear scope definition for both happy paths and negative scenarios.

Can I use rule-oriented checklists instead of Given/When/Then for acceptance criteria?

Yes, rule-oriented checklists can be used instead of Given/When/Then to generate clear acceptance criteria. This format helps define measurable outcomes and comprehensive scenario coverage, ensuring requirements remain testable while accommodating complex business rules and negative paths effectively.

Why does my user story lack clear scope definition and testable outcomes?

User stories lack clear scope and testable outcomes when acceptance criteria are ambiguous. Applying INVEST principles and structured formats like Given/When/Then generates measurable requirements, ensuring comprehensive scenario coverage including negative paths, which reduces ambiguity and defines what 'done' means.