acceptance-criteria-builder

Convert ambiguous product intent into verifiable acceptance criteria with explicit actors and outcomes.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill acceptance-criteria-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-criteria-builder
Source: https://github.com/machenjie/rd-skills/tree/main/src/professional-skills/acceptance-criteria-builder
Command: npx skills add https://github.com/machenjie/rd-skills --skill acceptance-criteria-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Converts ambiguous product-change intent into a complete, verifiable acceptance-criteria contract so teams can implement, review, and verify changes without hidden assumptions.

Core Features & Use Cases

  • Defines acceptance criteria with explicit actors, preconditions, actions, postconditions, rejection criteria, and verification methods.
  • Ensures full behavioral coverage across happy paths, negative paths, edge cases, permission/authorization cases, regression considerations, and non-functional requirements.
  • Produces experiment-quality criteria when rollout decisions depend on metrics, including guardrails, exposure events, assignment units, and rollback/rejection thresholds.
  • Helps avoid implementation coupling by specifying what must be true rather than how it is built, and by surfacing open questions as explicit placeholders.

Quick Start

Use the acceptance-criteria-builder to generate a complete Gherkin-style, verifiable acceptance set for your change by providing the feature description and required constraints.

Frequently Asked Questions about acceptance-criteria-builder

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

FAQPage Schema
How do I write testable acceptance criteria for ambiguous product features?

Testable acceptance criteria are generated by transforming ambiguous product intent into a contract with explicit actors, preconditions, actions, postconditions, rejection criteria, and verification methods. This ensures user-facing behaviors and business rules are independently verifiable without hidden assumptions.

How do I write Gherkin-style acceptance criteria for API contracts and non-functional requirements?

You can generate Gherkin-style acceptance criteria by providing the feature description and required constraints. The output specifies what must be true for API contracts and sets measurable non-functional thresholds for performance and security authorization without dictating implementation details.

What's the best way to define acceptance criteria for experiment rollouts and metric guardrails?

For experiment rollouts, acceptance criteria should define exposure events, assignment units, guardrail metrics, and rollback or rejection thresholds. This produces experiment-quality criteria ensuring rollout decisions are driven by measurable data rather than subjective judgments.

Does the acceptance-criteria-builder handle negative paths and edge cases?

Yes, it ensures full behavioral coverage across happy paths, negative paths, edge cases, and permission or authorization cases. It systematically maps these scenarios to observable outcomes and explicit rejection criteria to prevent gaps in regression coverage.

How do I avoid implementation coupling when defining acceptance criteria?

To avoid implementation coupling, acceptance criteria should specify what must be true rather than how it is built. This approach focuses on observable outcomes and verification methods, while surfacing any open questions as explicit placeholders for the development team.