qa-acceptance

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

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

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 validation plan that any reviewer can execute against the running app and decide pass or fail with evidence. ## Core Features & Use Cases - Structured Acceptance Criteria: Writes each criterion as a single Given/When/Then statement that is independently verifiable and free of implementation details. - Mandatory Coverage Checklist: Ensures every plan covers golden path, empty states, boundary inputs, error states, concurrency, performance envelope, backward compatibility, and telemetry. - Evidence-Based Handoff: Returns a Pass/Fail/Blocked report with screenshots, logs, or timing data so authors can turn failures into fixes or tracked deferrals. - Use Case: A pull request changes the CSV export flow. Use this Skill to generate the acceptance plan covering zero-row exports, max-length inputs, network failure, and concurrent edits, then hand it to QA for a pre-release validation pass. ## Quick Start Write QA acceptance criteria and a manual validation plan for the new CSV export feature covering golden path, edge cases, and error states.

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 acceptance criterion as a single Given/When/Then statement describing an observable outcome, such as what the UI shows after an action. Keep each criterion independently verifiable and avoid combining multiple actions or outcomes into one line.

What should a QA validation plan cover before release?

A validation plan should cover the golden path, empty and minimum states, boundary inputs, error states like network failure and 404s, concurrency, performance limits, backward compatibility, and telemetry. Mark genuinely inapplicable sections as N/A with a reason rather than omitting them.

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 to 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 cannot be audited by reviewers.

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.