skills.rest
posit-dev
posit-devOFFICIAL
Explore all skills by this author →
GitHub

positron-pr-helper

Generates structured GitHub PR bodies with dynamically fetched e2e test tags.

4.2k|179|Updated May 24, 2022
Search Tags:#positron#E2E Testing#gitHub#PR template#Code review#Pull request#test tags
One-click install
npx skills add https://github.com/posit-dev/positron --skill positron-pr-helper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: positron-pr-helper
Source: https://github.com/posit-dev/positron/tree/main/.claude/skills/positron-pr-helper
Command: npx skills add https://github.com/posit-dev/positron --skill positron-pr-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Writing consistent, well-structured pull request bodies for the Positron repository is repetitive and error-prone, especially keeping the list of e2e test tags current and avoiding accidental CI triggers from stray tag strings.

Core Features & Use Cases

  • Structured PR Body Generation: Produces PR bodies following Positron conventions with opening lines, release notes, and validation steps for bug fixes, features, UI changes, and maintenance work.
  • Dynamic Test Tag Fetching: Runs a shell script that parses test-tags.ts to extract and categorize current e2e test tags (feature, platform, performance, special) in markdown, JSON, or list formats.
  • Test Coverage Preview: Integrates a local PETE check to flag changes lacking unit or e2e coverage before the PR is opened.
  • Use Case: After fixing a Data Explorer bug, ask for a PR body and receive a complete draft with the correct issue-closing keyword, release notes entry, and the right e2e tags in the Validation Steps section.

Quick Start

Ask the assistant to create a PR body for your current Positron changes, providing the issue number and a short summary of what the PR does.

Frequently Asked Questions about positron-pr-helper

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

FAQPage Schema
How do I create a PR body for the Positron repository?▼

Provide the issue number, PR type, and a short summary, and the skill drafts a complete body with opening line, release notes, and validation steps. It fetches current e2e test tags from test-tags.ts so the tag list is always up to date.

How do I get the current list of e2e test tags in Positron?▼

Run the fetch-test-tags.sh script, which parses test/e2e/infra/test-runner/test-tags.ts without TypeScript compilation. It outputs categorized tags (feature, platform, performance, special) in markdown, JSON, or plain list format.

Why did an unintended e2e test suite run on my PR?▼

CI extracts tags with a raw grep for @:tag substrings across the entire PR body, including backticked text. Any literal @:tag outside the Validation Steps section triggers that suite, so refer to areas by name without the prefix elsewhere.

Does this skill check test coverage before opening a PR?▼

Yes, it runs a local PETE preview against your working tree that flags substantive source changes lacking unit or e2e coverage. The authoritative check runs in CI by commenting /pete on the open PR.

What are the prerequisites for using this PR helper?▼

You need the GitHub CLI (gh) installed and authenticated, a working checkout of the posit-dev/positron repository, and access to the test-tags.ts file. The tag extraction script runs in under a second with no TypeScript build step.

Related Skills

Explore More Software Engineering Skills→
amotion-aiamotion-ai

close

Verify tests, commit changes, push branch, and create a pull request.

Official
Intermediate
kevinnftkevinnft
13

github-pr-workflow

Coordinate GitHub pull request lifecycles from branch creation to merge.

Community
Advanced
ncukondoncukondo
5

review-task

...

Community
Intermediate
mParticlemParticle
7

pr

Create a GitHub pull request from the current branch with a conventional-commits-based title and descriptive body.

Official
Advanced