Back to Skills

qa

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

67,197stars5,778forksUpdated 5/9/2026

Security Assessment

Safe(100/100)
Security Score100/100

About qa

The QA skill provides an interactive environment for users to report bugs, issues, or unexpected behavior in a codebase conversationally. It streamlines the process of documenting problems and filing GitHub issues without requiring users to navigate issue templates manually. By exploring the codebase in the background, the skill gathers context and domain-specific language, ensuring that issues are written clearly and from the user's perspective. This approach helps maintain issue durability and relevance even after major refactors, bridging the gap between user experience and technical implementation.

The main features of this skill include guided clarification of user-reported problems, background codebase exploration to understand domain language and feature behavior, and intelligent assessment of whether a report should be filed as a single issue or broken into multiple dependent issues. It generates structured GitHub issues using standardized templates for both single and multi-part reports, prioritizing clarity, reproducibility, and domain terminology over internal implementation details. The system can manage complex scenarios by creating dependent sub-issues and marking blocking relationships, allowing parallel workstreams and efficient tracking of problem resolution.

This skill is particularly useful for developers, QA engineers, product managers, and anyone involved in software testing or bug reporting. It is suited for teams looking to improve the quality and maintainability of their issue tracking process, especially in projects with complex codebases or rich domain-specific language. Users can employ it during active QA sessions, exploratory testing, or whenever conversational reporting of issues is preferred over traditional issue filing methods, enabling faster and more accurate communication of software problems.

FAQ

How do I start a QA session with this skill?

You can initiate a QA session by describing the bug or issue you are encountering. The agent will guide you through clarifying questions and automatically handle issue filing.

Can this skill explore any codebase?

The skill explores the relevant parts of the codebase in the background to gather context and domain language. It does not fix issues or reference internal file paths in the GitHub issues.

Will I need to review the issues before they are filed?

No, the skill automatically creates GitHub issues based on your reports. Issues are written from the user's perspective and are designed to be durable and clear.

How does the skill handle complex problems with multiple failure points?

It assesses whether a problem should be filed as a single issue or broken into multiple dependent sub-issues. Each sub-issue is independently verifiable and can be tracked with blocking relationships.

Are internal implementation details included in the issues?

No, the issues focus on user-facing behavior and domain language. Internal file paths, line numbers, or module names are not referenced in the issues.

Install qa

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill