qa-acceptance

Write QA acceptance criteria and manual validation plans for feature changes.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/nabitllc/todero --skill qa-acceptance-nabitllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-acceptance
Source: https://github.com/nabitllc/todero/tree/main/packages/skills-catalog/catalog/bundled/quality/qa-acceptance
Command: npx skills add https://github.com/nabitllc/todero --skill qa-acceptance-nabitllc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature changes often reach QA without a clear, independently verifiable definition of done, forcing reviewers to guess what to test or ask the author. This Skill produces acceptance criteria and a manual validation plan that any reviewer can execute against the running app and decide pass or fail without ambiguity. ## Core Features & Use Cases - Structured Acceptance Criteria: Generates Given/When/Then criteria covering golden path, empty states, boundary inputs, error states, concurrency, performance, backward compatibility, and telemetry. - Evidence-Based Validation: Requires screenshots, console output, log snippets, or timing measurements for every criterion so results are auditable. - Handoff Report: Produces a Pass/Fail/Blocked summary the author uses to turn failures into fixes or tracked deferrals. - Use Case: A PR changes the CSV export flow. Use this Skill to produce a validation plan covering zero-row exports, max-length inputs, network failure, and concurrent edits, then run the pass and return evidence-backed results. ## Quick Start Write QA acceptance criteria and a validation plan for the feature change described in this pull request.

Frequently Asked Questions about qa-acceptance

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

FAQPage Schema
How do I write acceptance criteria for a feature change?

Write each criterion as a single Given/When/Then statement describing starting state, action, and observable outcome. Cover the golden path, empty states, boundary inputs, error states, concurrency, performance, backward compatibility, and telemetry, marking non-applicable sections explicitly.

What should a QA validation plan include before release?

A validation plan should include the golden path flow, empty and minimum states, boundary inputs like max-length strings and unicode, error states such as network failure and 404s, concurrency scenarios, performance envelope, backward compatibility, and telemetry checks.

When should I not write acceptance criteria?

Skip acceptance criteria for unit-test-only changes like utility refactors or internal renames, where they add churn without value. Also avoid them for API contract verification, which belongs in contract testing rather than feature-level QA.

What evidence is needed to pass a QA acceptance criterion?

Each criterion needs concrete evidence: screenshots or clips for UI behavior, console or network output for API behavior, log snippets for telemetry, and timing measurements for performance. A pass without evidence is not auditable and does not count.

What happens when an acceptance criterion fails during QA?

A failing criterion blocks acceptance unless the owner explicitly waives it with a tracked follow-up issue. The validation report returns Pass, Fail, and Blocked sections to the author, who owns converting failures into fixes or accepted deferrals.