manual-qa

Plans and executes manual QA checks from Jira tickets, PR diffs, and preview environments.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/OktayCopurlu/ai-shared --skill manual-qa-oktaycopurlu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: manual-qa
Source: https://github.com/OktayCopurlu/ai-shared/tree/main/.github/workflows/skills/manual-qa
Command: npx skills add https://github.com/OktayCopurlu/ai-shared --skill manual-qa-oktaycopurlu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automated tests and CI pipelines do not prove that a change actually works for users. This Skill closes that gap by creating a structured QA plan from tickets and diffs, executing the checks in a real environment, and reporting evidence-backed results. ## Core Features & Use Cases - Risk-Based QA Depth: Selects smoke, focused, or full coverage based on change risk, from docs-only edits to checkout and auth flows. - Diff-Driven Regression Checks: Automatically adds regression coverage for shared components, stores, GraphQL queries, feature flags, and files outside the ticket scope. - Evidence-Based Reporting: Executes checks against preview URLs or local environments and records concrete evidence such as URLs, viewports, console output, and network payloads. - Use Case: After finishing a Jira ticket that changes a pricing component, run this Skill to validate the acceptance criteria in the preview deployment, check one adjacent consumer of the shared component, and produce a pass/fail report with evidence before PR handoff. ## Quick Start Ask the agent to run manual QA on the current PR or ticket, providing the ticket link and preview URL so it can plan, execute, and report the checks.

Frequently Asked Questions about manual-qa

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

FAQPage Schema
How do I run manual QA on a pull request before merging?▼

Provide the PR URL or number along with a preview URL. The workflow gathers the ticket, diff, and CI status, writes a temporary QA plan, executes each check in the environment, and reports a verdict with evidence for every check.

What is the difference between smoke, focused, and full QA depth?▼

Smoke verifies only that the relevant surface loads, used for docs or config changes. Focused is the default for normal PRs, covering ticket scenarios plus targeted regressions. Full covers primary flows, variants, and adjacent consumers for high-risk changes like checkout, auth, or pricing.

Does manual QA replace automated tests and CI checks?▼

No. Manual QA complements automated tests, type checks, and lint by covering human-facing functional behavior those gates cannot prove, such as preview behavior, feature flag states, tracking payloads, and adjacent UI regressions.

How are regression checks chosen for files outside the ticket scope?▼

The diff is scanned for shared components, composables, stores, GraphQL queries, routing, and tracking changes. Each triggers a targeted regression check on an adjacent consumer or flow, and unexplained files get a check or are marked not verified.

What happens when the preview URL or target UI is not reachable?▼

The workflow follows a validation recovery protocol, trying alternate routes, data states, locales, flags, and local fallbacks before marking a check blocked. All recovery attempts are recorded as evidence for blocked or not-verified items.