positron-qa-verify
Generates clear, actionable verification guides for QA testing of Positron bug fixes and features
How do I install this agent skill?
npx skills add https://github.com/posit-dev/positron --skill positron-qa-verifyIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates the creation of QA verification guides by retrieving and analyzing GitHub issues and pull requests using the GitHub CLI and local scripts. It is designed to run non-interactively and provides templates for reporting test results, including auto-detection of environment versions. While the skill's operations are transparent and follow vendor-appropriate patterns, it is susceptible to indirect prompt injection via the untrusted GitHub content it processes.
- Socketwarn
1 alert: gptAnomaly
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
4/4 files flagged
What does this agent skill do?
Positron QA Verify
Analyzes GitHub issues and PRs to generate verification guides for manual QA testing.
When to Use
- Assigned a ticket from the QA verification board (https://github.com/orgs/posit-dev/projects/2/views/8)
- Need test scenarios for a bug fix or feature
- Want to extract edge cases from issue comments and PR discussions
Prerequisites
- GitHub CLI (
gh) authenticated - Working in the Positron repository
Execution Mode
CRITICAL: Run non-interactively without prompts.
- Never use
AskUserQuestion- Always write to.claude/skills/positron-qa-verify/output/ - Version detection is best-effort - If it fails, use empty values silently
- Fail fast - Don't block on timeouts or missing data
Input
Issue number or URL:
4567#4567https://github.com/posit-dev/positron/issues/4567
Workflow
Steps 1 & 2: Fetch Issue and Find PRs (Parallel)
Run these in parallel with a single message containing multiple Bash tool calls:
gh issue view <number> --repo posit-dev/positron --json title,body,comments,url,labels,authorgh pr list --repo posit-dev/positron --search "<number>" --state all --json number,title
Step 3: Analyze PR Context
Fetch primary PR details:
gh pr view <pr-number> --repo posit-dev/positron --json title,body,comments,additions,deletions,url
Fetch all related PRs/issues mentioned in the body in parallel.
Step 4: Review Code Changes (Conditional)
Only for PRs < 500 lines (additions + deletions from Step 3):
gh pr diff <pr-number> --repo posit-dev/positron
Skip diff for large PRs - use PR description and comments instead.
Step 5: Extract Linked Issues
Search comments for #1234 references, additional test scenarios, edge cases, and platform-specific notes.
Step 6: Generate Verification Guide
Create markdown file in .claude/skills/positron-qa-verify/output/verify-issue-{number}-{timestamp}.md
See references/verification_guide.md for format and examples.
Step 7: Offer Verification Comment Template
After generating the guide, offer to create a verification comment template.
Only when user accepts:
- Run
scripts/detect_versions.shto auto-detect Positron and OS versions - Generate comment template with scenarios from the guide
- Copy to clipboard
Comment format:
- Single scenario (no edge cases/regressions): Simple bullet format
- Multiple scenarios: Grouped format with Primary/Edge cases/Regression checks sections
Output
.claude/skills/positron-qa-verify/output/verify-issue-{number}-{timestamp}.md
Helper Scripts
scripts/detect_versions.sh
Fast, silent version detection (max 4 seconds):
./scripts/detect_versions.sh
Output:
{
"positronVersion": "2026.02.0",
"positronBuild": "10",
"osVersion": "macOS 26.2",
"detectionStatus": "success"
}
Never prompts or shows errors - returns empty values on failure.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/posit-dev/positron/positron-qa-verify">View positron-qa-verify on skillZs</a>