authoring-test-plan

Write risk-weighted test plans with traceable cases derived from feature and API specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a QA test plan from scratch often produces vague coverage claims, combinatorial case explosions, or untestable exit criteria. This Skill guides the authoring of a test plan where every case traces to a real upstream behavior, the catalog is sized by risk rather than the input cross-product, and done-criteria are mechanically decidable. ## Core Features & Use Cases - Coverage-map-first method: Derives every test case from a feature-spec behavior/acceptance criterion or an api-spec operation/error, so no behavior is left untested and no case is invented. - Risk-weighted case design: Applies BVA, equivalence partitioning, decision tables, state-transition testing, and pairwise selection so high-risk areas get depth without combinatorial blow-up. - Non-functional and ML testing guidance: Carries numeric targets for performance, security, and WCAG 2.2 AA accessibility, plus metric-threshold-on-a-named-dataset cases for ML/probabilistic behavior. - Versioned amends: Handles change requests as scoped deltas with impact+risk regression selection instead of full rewrites. - Use Case: Given an approved feature-spec and api-spec for a login service, produce a test plan with a coverage matrix, executable cases (including the exact 401/429 error expectations), testable exit criteria tied to an open-defect threshold, and a performance target from the NFRs. ## Quick Start Use authoring-test-plan to turn docs/specs/auth-v2-feature-spec.md and the api-spec into a complete test plan with a traceable, risk-weighted case catalog.

Frequently Asked Questions about authoring-test-plan

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

FAQPage Schema
How do I write a test plan from a feature specification?

Build a coverage map first: every feature-spec behavior and acceptance criterion becomes a row mapped to the test level that proves it. Then derive each test case from a row, choosing the cheapest proving level and risk-weighting depth with techniques like boundary value analysis and equivalence partitioning.

How many test cases should a test plan include?

Size the catalog by risk, not by the input cross-product. Every behavior gets at least one traceable case, high-risk areas get extra boundary and negative cases via BVA, decision tables, or pairwise selection, and low-risk areas get happy-path-only coverage.

How do you test ML or probabilistic features in a test plan?

Use metric-threshold validation on a named dataset, such as precision@10 >= 0.85 on eval-v3, or metamorphic relations that assert input-change to output-change invariants. A deterministic pass/fail expected result mis-fits systems with no fixed oracle.

What makes test plan exit criteria testable?

Exit criteria must be observable and measurable, such as all High-priority cases passing, no open Critical/High defects, and every coverage-map row having a passing case. Phrase coverage against requirements and risk, not a bare code-coverage percentage.

When should I amend a test plan instead of rewriting it?

Amend when an upstream behavior changes or a defect is discovered. Scope the change, edit affected rows and cases in place, re-trace the coverage map, select the regression set by impact plus risk, and version the plan with a changelog rather than regenerating it.

Does this skill write the actual test automation code?

No. It specifies what to test and the concrete cases, including preconditions, steps, and expected results, but the executable pytest or Playwright scripts are downstream implementation. It also does not replace the release runbook's operational verification.