validate-install-scripts

name	validate-install-scripts
description	> Use when this capability is needed.

Validate Install Scripts in Key Repos

This skill automates the "Validation in Key Repos" step of the install scripts release process. It opens draft PRs titled [DO NOT MERGE] Install Scripts Update Validation PR in key .NET repos that replace the production install script URL with a raw GitHub URL pointing to a specific commit.

Prerequisites

• The gh CLI must be authenticated with permissions to create branches and PRs in the target repos.
• The commit SHA must exist in the dotnet/install-scripts repository on GitHub.
• If the user lacks push access to a target repo, the scripts automatically fork and create cross-fork PRs.

Usage

Mode 1: Open Validation PRs

Ask the user for the commit SHA, then run:

pwsh .github/skills/validate-install-scripts/Open-ValidationPRs.ps1 -CommitSha "<sha>"

To target specific repos only:

pwsh .github/skills/validate-install-scripts/Open-ValidationPRs.ps1 -CommitSha "<sha>" -Repos @("arcade", "sdk")

Mode 2: Check CI Status and Close PRs

Ask the user for the same commit SHA used to open the PRs, then run:

pwsh .github/skills/validate-install-scripts/Close-ValidationPRs.ps1 -CommitSha "<sha>"

To auto-close without prompting:

pwsh .github/skills/validate-install-scripts/Close-ValidationPRs.ps1 -CommitSha "<sha>" -AutoClose

Target Repositories

• dotnet/aspnetcore
• dotnet/arcade
• dotnet/sdk
• dotnet/runtime
• dotnet/winforms

What the Scripts Do

Both scripts use the gh CLI and GitHub's Git Data API. The open script:

1. Verifies the commit exists in dotnet/install-scripts
2. For each target repo:
   • Checks push access; if denied, forks the repo automatically
   • Creates a branch named validate-install-scripts/<short-sha>
   • Fetches eng/common/tools.sh and eng/common/tools.ps1
   • Replaces the production URL with the raw GitHub URL for the given commit
   • Creates an atomic commit (both files in one commit) via the Git Data API
   • Opens a draft PR

The close script:

1. Finds open validation PRs by branch name (handles both direct and fork-based PRs)
2. Checks CI status on each
3. Closes PRs where all checks have passed, reports pending/failed ones

URL Replacements

In eng/common/tools.sh:

https://builds.dotnet.microsoft.com/dotnet/scripts/$dotnetInstallScriptVersion/dotnet-install.sh
→ https://raw.githubusercontent.com/dotnet/install-scripts/<COMMIT_SHA>/src/dotnet-install.sh

In eng/common/tools.ps1:

https://builds.dotnet.microsoft.com/dotnet/scripts/$dotnetInstallScriptVersion/dotnet-install.ps1
→ https://raw.githubusercontent.com/dotnet/install-scripts/<COMMIT_SHA>/src/dotnet-install.ps1

Notes

• PRs are opened as drafts with [DO NOT MERGE] title to prevent accidental merge.
• File content is round-tripped through base64 to preserve exact bytes (no trailing whitespace changes).
• The branch name validate-install-scripts/<short-sha> correlates open and check-close modes.
• CI run times vary: Arcade ~30 min, Runtime can take several hours.

---

Source: dotnet/install-scripts — distributed by TomeVault.