QA Evidence Pack

Build acceptance-criteria-mapped QA evidence reports with observable outcomes and annotated visual artifacts.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/jterratsdev/smart-deployment --skill qa-evidence-pack-jterratsdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: QA Evidence Pack
Source: https://github.com/jterratsdev/smart-deployment/tree/main/skills/qa-evidence-pack
Command: npx skills add https://github.com/jterratsdev/smart-deployment --skill qa-evidence-pack-jterratsdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? QA work often produces raw logs and passing test runs without proof that acceptance criteria were actually met, leaving reviewers without reviewable evidence before release. ## Core Features & Use Cases - Acceptance Criteria Mapping: Map every criterion to automated, manual, contract/mock, external verification, or deferred status with owner and rationale. - Observable Outcome Capture: Record screenshots, Playwright traces, videos, CLI stdout/stderr, API contracts, and webhook correlation IDs instead of raw logs. - Annotated Visual Defects: Create annotated screenshots using color-coded overlays for clipped elements, wrong connectors, spacing defects, and alignment issues. - Use Case: Before releasing a feature, generate a compact evidence report linking each acceptance criterion to screenshots, traces, and external verification so Product and Architecture can sign off. ## Quick Start Ask the agent to build a QA evidence pack for the current GitHub issue mapping each acceptance criterion to captured screenshots, traces, and command outputs.

Frequently Asked Questions about QA Evidence Pack

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

FAQPage Schema
How do I create QA evidence for acceptance criteria?

Identify the issue and acceptance criteria, then map each criterion to automated, manual, contract/mock, external verification, or deferred status. Capture observable outcomes like screenshots, traces, and command outputs, and summarize them in a compact evidence report.

What evidence should I capture for Playwright e2e tests?

Capture visible state screenshots, Playwright traces, and videos for failures or critical flows, along with viewport and device context. Store large artifacts as files and reference their paths from the evidence report.

How do I document visual bugs with annotated screenshots?

Use concise overlays: red rectangles for clipped or overlapping elements, orange arrows for wrong connectors, yellow translucent areas for spacing defects, blue guide lines for alignment, and short labels naming each defect.

Is a passing test enough as QA evidence for release?

No. A passing test without observable-result validation is not sufficient evidence, and a report without acceptance-criteria mapping is incomplete for release. External integrations also need receiver-side evidence or explicit deferral.

What evidence is needed for API and webhook integration testing?

Capture request shape, response and error contracts, idempotency behavior, and side effects. For integrations, record sandbox or mock receiver results, webhook events, correlation IDs, and database evidence, or defer with an owner and rationale.