microsoft/pac-cli-update
Bump PAC CLI binary version and/or cli-wrapper npm package. Always produces two PRs — main and release/stable.
npx skills add https://github.com/microsoft/powerplatform-build-tools --skill pac-cli-update
Handles the most common update in this repo: bumping the PAC CLI binary version and/or
the @microsoft/powerplatform-cli-wrapper npm package.
Invoke as:
/pac-cli-update <pac-version> — e.g. /pac-cli-update 1.53.2/pac-cli-update <pac-version> <wrapper-version> — when cli-wrapper also has a new versionAlways produces two PRs: one targeting main, one targeting release/stable.
This is the standard release pattern for this repo — never merge a CLI update to only one branch.
grep "## Last sync" memory/ado-knowledge.md 2>/dev/null | tail -1
If last sync was > 7 days ago or missing: run /knowledge-sync inline, then continue.
# Confirm the version is published before touching any files
curl -s "https://api.nuget.org/v3-flatcontainer/microsoft.powerapps.cli/index.json" \
| node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); console.log(d.versions.slice(-5).join('\n'))" 2>&1
# Confirm the linux package also exists (both must be present)
curl -s "https://api.nuget.org/v3-flatcontainer/microsoft.powerapps.cli.core.linux-x64/index.json" \
| node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); console.log(d.versions.includes('<pac-version>') ? 'linux: found' : 'linux: NOT FOUND')" 2>&1
If the version does not exist on nuget.org, stop and report — do not create a PR for a non-existent version.
git fetch origin 2>&1
git checkout main 2>&1
git merge origin/main --no-edit 2>&1
git checkout -b users/<alias>/cli-version-<pac-version> 2>&1
Edit both packages to the new version:
{
"packages": [
{ "name": "Microsoft.PowerApps.CLI", "version": "<pac-version>", ... },
{ "name": "Microsoft.PowerApps.CLI.Core.linux-x64", "version": "<pac-version>", ... }
]
}
Both packages must always use the same version. Never update only one.
Add a new entry under {{NextReleaseVersion}}: (do not remove the placeholder — it stays):
{{NextReleaseVersion}}:
- pac CLI <major.minor>, [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/<pac-version>#releasenotes-body-tab)
If additional changes are in this update (new task, Node target bump, etc.), add bullet points below the pac CLI line.
Only do this if a <wrapper-version> argument was given OR if the cli-wrapper changelog
explicitly requires the new pac CLI version:
npm view @microsoft/powerplatform-cli-wrapper versions --json 2>&1 | tail -1
If updating, bump "@microsoft/powerplatform-cli-wrapper" in package.json dependencies
and run npm install.
npm install 2>&1 | tail -5
npm run ci 2>&1
npm run ci runs: clean → compile → lint → restore (downloads the new pac CLI version) → unitTest → pack.
Functional tests will fail locally (require live credentials) — expected, not a blocker.
If restore fails (pac CLI version not found), the version does not exist — stop and report.
git add nuget.json extension/overview.md package.json package-lock.json
git status # confirm only these files staged
git commit -m "chore: update pac CLI to <pac-version>"
git push -u origin HEAD 2>&1
Create the main-branch PR:
gh pr create \
--base main \
--title "Update pac CLI to <pac-version>" \
--body "$(cat <<'EOF'
## Summary
- Bump PAC CLI from <old-version> to <pac-version>
- [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/<pac-version>#releasenotes-body-tab)
## Changes
- `nuget.json`: both `Microsoft.PowerApps.CLI` and `Microsoft.PowerApps.CLI.Core.linux-x64` updated to `<pac-version>`
- `extension/overview.md`: release notes entry added
## Test plan
- [ ] `npm run ci` passes locally (restore downloads new pac CLI version successfully)
- [ ] Functional tests exempt (require live env credentials)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
This is the production release. Create a second branch off release/stable:
git fetch origin 2>&1
git checkout release/stable 2>&1
git merge origin/release/stable --no-edit 2>&1
git checkout -b users/<alias>/cli-version-<pac-version>-release 2>&1
Cherry-pick the commit from Step 7:
git cherry-pick <commit-sha-from-step-7> 2>&1
git push -u origin HEAD 2>&1
Create the release PR:
gh pr create \
--base release/stable \
--title "[release] Update pac CLI to <pac-version>" \
--body "$(cat <<'EOF'
## Summary
- Bump PAC CLI from <old-version> to <pac-version> on the release/stable branch
- Mirrors: <main-branch-pr-url>
## Changes
- `nuget.json`: both packages updated to `<pac-version>`
- `extension/overview.md`: release notes entry added
## Test plan
- [ ] Main-branch PR verified first
- [ ] Functional tests exempt
🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
Print:
gulp restore download the new pac CLI successfully?)Then tell the user what to do after both PRs merge:
Once both PRs merge, queue the official build to sign, publish to Marketplace, and create the GitHub Release:
https://dev.azure.com/dynamicscrm/OneCRM/_build?definitionId=21491
Pipeline variables to set when queuing:
- GITHUB_TOKEN GitHub PAT (repo scope, SSO enabled for 'microsoft' org)
- AZ_DevOps_Read_PAT PAT to read from the AzDO DPX-Tools-Upstream feed
- isEsrpEnabled true
- PUBLISH_TO_MARKETPLACE true
On success, a published GitHub Release will appear automatically at:
https://github.com/microsoft/powerplatform-build-tools/releases/tag/v<new-extension-version>
That release will include:
- All 4 signed VSIXs (LIVE, BETA, DEV, EXPERIMENTAL) as assets
- Release notes extracted from `extension/overview.md`'s `{{NextReleaseVersion}}:` block
- Latest tag
If the release does not appear, check the "Create GitHub release with VSIX assets" task in the build log — usually GITHUB_TOKEN scope or SSO authorization is the issue.
nuget.json packages — both must match{{NextReleaseVersion}} placeholder in overview.md must stay — add below it, never replace itMicrosoft.PowerApps.CLI.Core.linux-x64) doesn't have the new version yet, wait — don't ship with mismatched versionsTake microsoft/pac-cli-update from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference npm.
Without those the skill loads but fails at the first command.