setup-pr-analysis

Set up the local environment for analyzing a specific PR/issue pair. Use this before running the bug-analyzer agent to checkout the parent commit and prepare context files.

Jump to install

Repository: rebornix/sounds-gucci
Last source activity: May 31, 2026 at 05:21
Detected SKILL.md language: English
Stars: 2
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	setup-pr-analysis
description	Set up the local environment for analyzing a specific PR/issue pair. Use this before running the bug-analyzer agent to checkout the parent commit and prepare context files.

Setup PR Analysis Skill

This skill prepares the local environment for analyzing a bug-fix PR by checking out the parent commit and gathering context.

Usage

Run the setup.sh script with the following parameters:

./setup.sh --pr <number> --issue <number> --repo <owner/repo> --clone-path <path> [--output-dir <path>] [--tags <comma-separated>]

Parameters

Parameter	Required	Description	Example
`--pr`	Yes	PR number to analyze	`12345`
`--issue`	Yes	Linked issue number	`12340`
`--repo`	Yes	Repository in `owner/repo` format	`microsoft/vscode`
`--clone-path`	Yes	Path to local repo clone	`/Users/penlv/Code/Work/vscode2`
`--output-dir`	No	Directory for context files (default: `data/analysis/<pr>`, but issue-keyed output is also supported)	`./context`
`--tags`	No	Comma-separated tags for categorization	`sessions,error-telemetry`

Example

# Setup analysis for PR #12345 linked to issue #12340
./.github/skills/setup-pr-analysis/setup.sh \
  --pr 12345 \
  --issue 12340 \
  --repo microsoft/vscode \
  --clone-path /Users/penlv/Code/Work/vscode2

What It Does

Fetches PR details: Gets merge commit, parent commit, PR description, changed files
Fetches issue details: Gets issue title, body, and all comments
Checks out parent commit: Switches local clone to the state before the fix
Generates context files:

issue.md - Issue title, body, and comments
metadata.json - PR/issue metadata (no model info)
actual_fix/pr.md - PR title, body, and commit messages (for fix-validator only)
actual_fix/pr-diff.patch - The actual PR diff (for validator comparison)
actual_fix/changed-files.txt - List of files changed in the PR

Output Structure

data/analysis/<pr>/
├── issue.md           # Issue context for bug-analyzer
├── metadata.json      # PR/issue metadata
└── actual_fix/        # Real solution (for fix-validator only)
    ├── pr.md          # PR description
    ├── pr-diff.patch  # Actual fix diff
    └── changed-files.txt

Prerequisites

gh CLI installed and authenticated
jq for JSON processing
Local clone of the repository at the specified path
Git access to checkout commits

Rate Limits

GitHub CLI calls are retried on primary/secondary rate-limit responses. Tune with:

GH_RETRY_MAX - retry attempts, default 5
GH_RETRY_BASE_DELAY - fallback delay multiplier in seconds, default 10
GH_RETRY_MAX_DELAY - maximum sleep between retries in seconds, default 300

Authentication and SSO failures are not retried.

Batch Setup

For issue-centric batches such as a month of bug issues, use the batch helper:

./.github/skills/setup-pr-analysis/setup-batch.sh \
  --input data/prs-with-issues-2026-03.md \
  --clone-path /Users/penlv/Code/Work/vscode \
  --key-by issue \
  --tags round-2,2026-03,bug

This reads the markdown manifest, skips retrospective rows by default, and refreshes each analysis directory with full metadata and actual-fix artifacts.