qa

Convert conversational bug reports into GitHub issues with reproduction steps.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drshailesh88/build_playbook --skill qa-drshailesh88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa
Source: https://github.com/drshailesh88/build_playbook/tree/main/vendor/mattpocock-skills/qa
Command: npx skills add https://github.com/drshailesh88/build_playbook --skill qa-drshailesh88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QA sessions help you report bugs conversationally while turning your report into clear, durable, user-focused GitHub issues with the right reproduction details.

Core Features & Use Cases

  • Conversational bug intake: You describe what went wrong, and the agent asks only a few targeted clarifying questions to confirm expected vs actual behavior.
  • Background codebase exploration: The agent explores the relevant area to learn the project’s domain language and intended behavior without exposing internal implementation details in the issue.
  • Scope-aware issue filing: The agent decides whether the report is a single issue or a breakdown into multiple thinner issues that can be fixed in parallel.

Quick Start

Use the qa skill when you want to describe a bug, issue, or odd behavior you encountered and have the agent file one or more GitHub issues with reproduction steps from your perspective.

Frequently Asked Questions about qa

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

FAQPage Schema
How do I turn conversational bug reports into GitHub issues with reproduction steps?

To turn bug reports into GitHub issues, the agent asks targeted clarifying questions during conversational intake to confirm expected versus actual behavior. It then generates durable, user-focused issues containing mandatory reproduction steps from the reporter's perspective.

What is the best way to scope a complex bug report into multiple GitHub issues?

Scoping a complex bug report involves analyzing the reported symptoms and desired outcomes to determine if the problem requires a single issue or a breakdown into multiple thinner issues. This scope-aware triage enables parallel fixes across the codebase.

How does codebase exploration help write better GitHub issues?

Codebase exploration helps write better GitHub issues by learning the project's domain language and intended behavior. This background exploration ensures the final issue text uses accurate terminology and avoids exposing stale internal implementation references.

Can I use conversational QA intake to report intermittent failures?

Yes, you can use conversational QA intake to report intermittent failures. The agent captures both consistent and intermittent symptoms, asks targeted clarifying questions to distinguish expected behavior, and translates the session into a structured issue.

When should I not include internal implementation references in a bug report?

You should not include internal implementation references in a bug report when writing user-focused GitHub issues. The agent enforces issue-writing rules that strip stale internal details, ensuring the report remains durable and centered on reproducible behavior.

Does the QA intake process triage bug scope automatically?

Yes, the QA intake process triages bug scope automatically. After clarifying expectations and capturing reproduction steps, the agent decides whether to file a single issue or split the report into multiple thinner issues for parallel resolution.