qa-checklist

Generates a QA checklist from branch changes and writes it into the PR body.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/vzakharov/vovazakharov.com --skill qa-checklist-vzakharov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-checklist
Source: https://github.com/vzakharov/vovazakharov.com/tree/main/.claude/skills/qa-checklist
Command: npx skills add https://github.com/vzakharov/vovazakharov.com --skill qa-checklist-vzakharov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pull requests often ship without a concrete, human-verifiable checklist, leaving reviewers to guess how to validate a change. This Skill derives a manual QA checklist from the branch's plan, PR summary, or commits and writes it into the PR body as a ## QA Checklist section, complete with a table classifying each step's automatability and test coverage. ## Core Features & Use Cases - Checklist derivation: Builds concrete, user-visible verification steps from the plan under docs/plans/, the PR body Summary, or commit history — not generic advice like "run the tests". - Automatability classification: Emits a slug-keyed table marking each item as unit, integration, e2e, or manual-only, plus whether a backing test already exists, surfacing coverage gaps before merge. - Idempotent PR body updates: Pulls the live PR body via scripts/pr-body.py, edits only the QA section (recognizing legacy ## Manual QA and ## Test plan headings), and pushes it back without touching anything else. - Use Case: After implementing a streaming chat feature on a branch, run /qa-checklist to insert steps like "open the chat page, send a prompt, confirm the reply streams in" into the PR, with a table flagging that the streaming path lacks an e2e test. ## Quick Start Run /qa-checklist on the current branch to generate a manual QA checklist and write it into the open PR's body.

Frequently Asked Questions about qa-checklist

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

FAQPage Schema
How do I add a QA checklist to a GitHub pull request?

Run /qa-checklist on the branch with an open PR. It derives verification steps from the plan, PR summary, or commits, then edits the PR body in place via scripts/pr-body.py, inserting a ## QA Checklist section after the Summary.

How to classify which manual QA steps can be automated?

The Skill emits a table after the checklist classifying each item as unit, integration, e2e, or manual-only based on the project's layered test stack. It also marks whether a backing test already exists, flagging uncovered automatable rows as gaps.

Does the QA checklist skill create pull requests or run tests?

No. It only edits an existing PR body and never creates PRs, pushes commits, writes test code, or runs the vet suite. If no PR exists for the branch, it stops and tells you to open one first.

What happens if the PR body already has a QA checklist section?

The update is idempotent: a conforming existing checklist is left untouched, a stale or malformed section is replaced in place, and a missing section is inserted. Legacy ## Manual QA and ## Test plan headings are also recognized.

Why does gh fail to find the repository in remote sessions?

Some remote environments have a proxy quirk where gh cannot resolve the GitHub host from git remotes. Pass --repo OWNER/REPO explicitly, resolved from git remote get-url origin; the pr-body.py script accepts the same flag.