writing-acceptance-criteria

Convert approved product specifications into structured acceptance criteria with pass/fail checks.

63|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/xhyqaq/superpowers-plus --skill writing-acceptance-criteria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-acceptance-criteria
Source: https://github.com/xhyqaq/superpowers-plus/tree/main/skills/writing-acceptance-criteria
Command: npx skills add https://github.com/xhyqaq/superpowers-plus --skill writing-acceptance-criteria

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of misalignment between development teams and stakeholders caused by vague, untestable requirements after a product spec is approved, ensuring every requirement has a clear, verifiable pass/fail check before implementation begins.

Core Features & Use Cases

  • Structured Criteria Generation: Converts every spec requirement into a formatted acceptance criteria table with sequential IDs, defined test types, preconditions, and measurable expected results.
  • Hard Approval Gate: Blocks progression to implementation planning until all stakeholders explicitly approve the finalized acceptance criteria document.
  • Use Case: After a product team approves a spec for a new file upload feature, this Skill generates testable criteria (e.g., "AC-003: Upload fails for files over 10MB, expected result: 413 Payload Too Large error response") to eliminate implementation ambiguity.

Quick Start

Use the writing-acceptance-criteria skill to convert the approved spec for the new user dashboard feature into a structured, testable acceptance criteria document.

Frequently Asked Questions about writing-acceptance-criteria

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

FAQPage Schema
How do I convert product specs into testable acceptance criteria for software development?

Converting product specs into testable acceptance criteria involves transforming every stated requirement into a structured table with sequential IDs, defined test types, preconditions, and measurable expected results to ensure deterministic pass/fail checks before implementation begins.

What is the best way to write unambiguous requirements for TDD workflows?

The best way to write unambiguous requirements for TDD workflows is to generate verifiable pass/fail checks directly from the approved specification, aligning development teams and stakeholders on measurable expected results to eliminate rework.

Can I block implementation planning until stakeholders approve the acceptance criteria?

Yes, you can block implementation planning until stakeholders explicitly approve the finalized acceptance criteria document by enforcing a hard approval gate that halts progression to the execution phase.

How does spec conversion validate requirement pass/fail checks before coding starts?

Spec conversion validates requirement pass/fail checks by applying a structured transformation that maps every product spec requirement to a deterministic test type with specific preconditions and measurable expected results.

Does this acceptance criteria generation work after spec approval and before implementation planning?

Yes, acceptance criteria generation works specifically within the design, plan, execute, and verify process flow, acting after spec approval and before implementation planning to ensure all requirements are verifiable.

Why do vague software requirements cause misalignment between developers and stakeholders?

Vague software requirements cause misalignment because they lack deterministic pass/fail checks, leading to ambiguous deliverables that require rework; structuring requirements into testable acceptance criteria eliminates this implementation ambiguity.