powershell-pin-audit

Audits coordinated PowerShell version pins across workflows, .gitmodules, README.md, and the checked-out upstream PowerShell target framework.

Jump to install

Repository: Devolutions/pwsh-distro
Last source activity: July 22, 2026 at 18:36
Detected SKILL.md language: English
Stars: 15
Forks: 3

Install options

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

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Devolutions/pwsh-distro --skill powershell-pin-audit

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

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

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

powershell-release-bump

Upgrades to a new PowerShell release by mirroring its tag, porting downstream patches, publishing the downstream source branch, and coordinating workflow and submodule pins.

2026-08-14

powershell-sdk-package-validate

Builds and validates the local single-RID Devolutions.PowerShell.SDK package using the repository's current workflow pins.

2026-06-30

View all from this repository

powershell pin audit

Use this skill when updating the pinned PowerShell version, reviewing a PowerShell release bump, or checking that the repository's coordinated PowerShell pins still agree.

The audit checks the primary .github/workflows/powershell-sdk.yml workflow, the secondary .github/workflows/powershell-cli.yml workflow, .gitmodules, the README "Current pins" table, and pwsh-src/PowerShell.Common.props when the submodule is available.

Prerequisites

PowerShell 7 (pwsh).

Initialize pwsh-src/ before release-bump validation if you need target-framework verification.

Usage

Run the default audit from the repository root:

pwsh .\.agents\skills\powershell-pin-audit\scripts\Test-PowerShellPins.ps1

Require the pwsh-src/ submodule and fail if PowerShell.Common.props is unavailable:

pwsh .\.agents\skills\powershell-pin-audit\scripts\Test-PowerShellPins.ps1 -RequireSubmodule

Audit a different checkout:

pwsh .\.agents\skills\powershell-pin-audit\scripts\Test-PowerShellPins.ps1 -RepositoryRoot D:\dev\pwsh-distro

Checks

POWERSHELL_VERSION, POWERSHELL_RELEASE_TAG, POWERSHELL_UPSTREAM_TAG, and POWERSHELL_SOURCE_REF are present in both PowerShell workflows.

The two workflows use the same PowerShell pin values.

POWERSHELL_RELEASE_TAG is v$POWERSHELL_VERSION.

POWERSHELL_UPSTREAM_TAG is upstream/$POWERSHELL_RELEASE_TAG.

POWERSHELL_SOURCE_REF is downstream/$POWERSHELL_RELEASE_TAG.

The CLI workflow SDK package ID, version, and revision match the SDK workflow defaults.

.gitmodules tracks the same downstream branch as POWERSHELL_SOURCE_REF.

README "Current pins" records the same upstream release, downstream source ref, upstream base tag, and target framework.

If pwsh-src/PowerShell.Common.props exists, README's target framework matches its <TargetFramework> value.

name	powershell-pin-audit
description	Audits coordinated PowerShell version pins across workflows, .gitmodules, README.md, and the checked-out upstream PowerShell target framework.