pmai-upgrade

Upgrade the PMAI framework to the latest main commit or git tag with an AI-generated changelog summary.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-upgrade-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-upgrade
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/pmai-upgrade
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-upgrade-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping the globally installed PMAI framework current requires manually pulling remote commits, re-syncing skill symlinks, and reading raw changelogs. This Skill automates the full upgrade flow and turns the CHANGELOG diff into a concise natural-language summary of what changed. ## Core Features & Use Cases - Version Detection and Remote Check: Reads the current installed version from ~/.pmai, fetches remote main HEAD and latest git tags, and skips the upgrade when already up to date. - Interactive Upgrade Modes: Asks the user to choose between upgrading to main latest, the latest stable tag, a pinned tag version, or snoozing the update for 1 day, 1 week, or forever. - AI What's New Summary: Runs pmai upgrade with --no-whats-new, then reads the CHANGELOG between old and new versions and produces a 5-7 bullet summary grouped by theme (new capabilities, fixes, upgrade experience). - Use Case: A PM types /pmai-upgrade in Claude Code, picks "upgrade to main latest", and immediately sees a readable digest of new skills, bug fixes, and behavior changes without opening the raw CHANGELOG. ## Quick Start Ask the AI to run /pmai-upgrade to check for a new PMAI version, choose an upgrade mode, and show a summary of what changed.

Frequently Asked Questions about pmai-upgrade

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

FAQPage Schema
How do I upgrade the PMAI framework to the latest version?

Run /pmai-upgrade in Claude Code or Codex. The skill checks the remote main HEAD and latest git tag, asks which upgrade mode you want, then runs pmai upgrade and shows an AI-generated summary of the changes.

How do I upgrade PMAI to a specific version or stable tag?

During the upgrade prompt, choose the stable tag option to jump to the latest tagged release, or the pinned option to enter a version like v0.x.0. The skill runs pmai upgrade --stable or pmai upgrade --to <version> accordingly.

Can I postpone or snooze PMAI update reminders?

Yes. Choose the snooze option and pick 1 day, 1 week, or forever. The skill writes a timestamp to ~/.pmai-state/update-snoozed so pmai update-check stays silent during that period; delete that file to restore reminders.

Does pmai-upgrade work if PMAI is not installed globally?

No. The skill checks for ~/.pmai/.git and exits with an error if the global installation is missing, pointing you to the install script. Upgrades only apply to the global installation shared by all projects.

What happens to the What's New summary during a PMAI upgrade?

The skill runs pmai upgrade with --no-whats-new so the CLI does not print its own summary, then reads the CHANGELOG sections between the old and new versions and produces a 5-7 bullet digest grouped by new capabilities, fixes, and upgrade experience.