positron-qa-verify

The positron-qa-verify skill is a specialized automation tool designed for software engineers and QA testers working within the Positron repository. It streamlines the manual quality assurance process by programmatically synthesizing verification guides from existing GitHub data. Instead of manually reviewing code diffs and issue threads, users can provide an issue number to trigger an automated analysis that extracts key test scenarios, edge cases, and relevant documentation from linked pull requests and discussions.

• Automatically fetches issue metadata, PR descriptions, and linked discussions using the GitHub CLI (gh).
• Analyzes code changes (for PRs under 500 lines) to identify affected components and potential regressions.
• Generates structured, markdown-formatted verification guides that detail explicit testing steps.
• Detects environment versions including Positron build numbers and OS details for accurate bug reproduction.
• Provides a configurable verification comment template to facilitate standardized feedback in GitHub PRs.
• Operates in a non-interactive, fail-fast mode, writing outputs directly to the local project workspace at .claude/skills/positron-qa-verify/output/.

This tool is specifically engineered for use when a user is assigned a ticket from the Positron QA verification board. It is best suited for scenarios where a bug fix or a new feature requires comprehensive manual testing but lacks clear documentation. The skill prioritizes efficiency, ensuring that the verification workflow is consistent across the team. Inputs include issue URLs, issue numbers, or PR references. Outputs consist of high-quality markdown files and context-aware clipboard templates that include necessary diagnostic data. Users should ensure their GitHub CLI is authenticated and that they are operating within the root of the Positron repository to ensure all helper scripts, such as the version detection utility, execute successfully.