qa-task

Reviews technical tasks against success criteria, implementation phases, and non-functional requirements.

2|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/Gamaroff/agent-skills --skill qa-task-gamaroff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qa-task
Source: https://github.com/Gamaroff/agent-skills/tree/main/skills/qa-task
Command: npx skills add https://github.com/Gamaroff/agent-skills --skill qa-task-gamaroff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Technical work like refactoring, infrastructure changes, and technical debt reduction often ships without structured quality review, letting defects in migration paths, breaking changes, and system-wide non-functional requirements reach production undetected. ## Core Features & Use Cases - Success Criteria Validation: Verifies functional, performance, and code quality criteria against actual test results and implementation phase checkboxes. - Adversarial Diff Code Review: Dispatches a read-only review of the branch diff for correctness bugs, with a dedicated refute pass on the second QA cycle and a security boundary probe engine. - Quality Gate Decisions: Produces co-located QA report and gate YAML files with PASS/CONCERNS/FAIL/WAIVED verdicts, re-review scoping, and PR comment posting on GitHub or Bitbucket. - Use Case: A developer marks a refactoring task ready for QA; the skill checks the PR, runs the test suite, reviews the diff, assesses NFRs, documents issues as bug reports, and posts the gate decision to the pull request. ## Quick Start Ask the agent to run a QA review on the technical task at docs/tasks/task.12.caching-layer now that its implementation phases are complete.

Frequently Asked Questions about qa-task

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

FAQPage Schema
How do I run a QA review on a technical task?▼

Invoke the qa-task skill once the task document exists at docs/tasks/task.[id].[name], all implementation phases are checked complete, tests pass, and a pull request is open on the feature branch. The skill verifies prerequisites, runs tests, reviews the diff, and writes a gate decision.

What is the difference between story QA and technical task QA?▼

Story QA validates acceptance criteria for end-user features, while technical task QA validates success criteria across functional, performance, and code quality dimensions. Task QA also requires documented migration paths for breaking changes and assesses system-wide NFRs like reliability and maintainability.

Does the QA review require a pull request?▼

Yes, the skill halts if no pull request exists for the current branch because it posts the gate decision as a PR comment. It uses gh pr comment on GitHub and the REST API on Bitbucket, with posting treated as best-effort and non-blocking.

When does the skill skip a re-review of a task?▼

Re-review is skipped only when the prior gate is PASS with no issues, no source commits occurred since the gate, the task document has not been edited, and its status was not reopened. Any code or document change since the gate triggers a fresh review.

What happens when a QA gate fails?▼

A FAIL or CONCERNS gate documents all HIGH and MEDIUM severity issues as bug report files and returns the task for fixes. The qa-fix loop then addresses findings, and the next review cycle runs a full refute pass over the entire branch diff.