reviewing-test-plan

Review QA test plans against a 10-condition coverage and testability bar, emitting an approve or revise verdict.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill reviewing-test-plan-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-test-plan
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-test-plan
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-test-plan-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding whether a finished QA or verification test plan is good enough to execute is subjective and error-prone: reviewers rubber-stamp long catalogs, miss behaviors with no test case, or over-flag sound plans. This Skill acts as an independent acceptance gate that judges a test plan against a fixed 10-condition bar and returns a machine-parseable verdict with actionable findings. ## Core Features & Use Cases - Coverage completeness check: Enumerates every behavior, operation, and error case from the handed-in upstreams (feature-spec, api-spec, or PRD) and confirms each has at least one traceable test case. - Risk-weighted catalog judgment: Detects coverage gaps, combinatorial blow-ups, and padded or thin catalogs, plus checks entry/exit criteria, environments, test data, and warranted non-functional targets such as WCAG 2.2 AA and p95 latency. - Delta-scoped amend review: When a change request is handed in, judges only the delta, coverage re-tracing, and regression selection rather than re-reviewing the whole plan. - Use Case: After authoring a test plan for a checkout feature, run this gate with the plan plus the feature-spec and api-spec; it returns VERDICT: revise naming the uncovered behaviors and missing performance targets, or VERDICT: approve if every applicable condition passes. ## Quick Start Use reviewing-test-plan on docs/qa/checkout-test-plan.md against the feature-spec and api-spec, and give me the verdict with findings.

Frequently Asked Questions about reviewing-test-plan

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

FAQPage Schema
How do I review a test plan before testing begins?

Hand the finished test plan to this gate along with its upstream documents (feature-spec, api-spec, or PRD). It checks ten conditions covering traceable coverage, executable cases, testable entry and exit criteria, environments, and risk-weighted sizing, then emits VERDICT: approve or VERDICT: revise with actionable findings.

What makes a test plan fail a coverage review?

The highest-impact failure is an upstream behavior, operation, or error case with no traceable test case. Other failures include vague exit criteria, missing preconditions or observable expected results, combinatorial or padded catalogs, fabricated cases, and warranted non-functional types without numeric targets.

Can this review an amended test plan instead of a new one?

Yes. When a change request is handed in against an existing plan, the review is delta-scoped: it judges the delta, coverage re-tracing, regression set selection, and version changelog rather than re-reviewing the unchanged plan. Greenfield plans skip this condition entirely.

Does the review require specific test design techniques like decision tables?

No. Case-design techniques such as boundary value analysis, decision tables, and pairwise selection are treated as author aids judged by outcome. The gate never demands a named technique, only that catalog depth follows risk and coverage is complete.

When should I not use this test plan review gate?

Do not use it to author or fix a test plan, to review release runbooks or engineering design documents, or to judge executable test scripts such as pytest or Playwright code. It only judges the test plan document against the coverage and testability bar.