skills.rest
product-on-purpose
product-on-purposeOFFICIAL
Explore all skills by this author →
GitHub

utility-update-pm-skills

Checks for newer pm-skills releases and updates local installations after user confirmation.

640|81|Updated Jan 9, 2026
Search Tags:#report generation#backup#update#SemVer#pm-skills#version check#GitHub Releases
One-click install
npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-update-pm-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: utility-update-pm-skills
Source: https://github.com/product-on-purpose/pm-skills/tree/main/docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills
Command: npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-update-pm-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Keeping a local pm-skills installation current requires manually checking GitHub releases, downloading archives, and copying files, which is error-prone and easy to forget. This Skill automates version comparison, change preview, and the update itself while protecting local files.

Core Features & Use Cases

  • Version checking and comparison: Detects the local version from plugin.json, marketplace.json, CHANGELOG.md, or git tags, fetches the latest GitHub release, and classifies the update as major, minor, or patch.
  • Safe update workflow: Previews the file manifest, requires explicit user confirmation, offers a backup, and uses validated-before-copy so archives are verified before any files are overwritten.
  • Structured update reports: Generates reports from a template documenting new skills, updated files, validation results, and next steps, saved to _pm-skills/updates/.
  • Use Case: After a new pm-skills release is announced, run the update command to see exactly which of the 85 files will change, back up your current installation, apply the update, and receive a report summarizing new capabilities.

Quick Start

Ask the assistant to check whether a newer pm-skills release is available and update my local installation with a backup.

Frequently Asked Questions about utility-update-pm-skills

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

FAQPage Schema
How do I update pm-skills to the latest version?▼

Run the update command to trigger the full flow: pre-flight checks, version comparison, change preview, confirmation, optional backup, and file copy from the release ZIP. A structured report is saved to _pm-skills/updates/ when finished.

How can I check my pm-skills version without updating?▼

Use the --status flag to run only pre-flight checks and print your local version alongside the latest release version. No files are written and no report is generated in this mode.

Can I preview a pm-skills update before applying it?▼

Yes, the --report-only flag runs pre-flight and preview, then generates a report listing files that would be written and new capabilities, without modifying anything. The report is saved with a report-only banner.

Will updating pm-skills overwrite my local notes and custom files?▼

No. The updater only writes files present in the release ZIP and never touches docs/internal/, _NOTES/, or _pm-skills/. Files you added that are not in the upstream release are left untouched and never deleted.

What happens if the pm-skills update fails partway through?▼

The skill validates the downloaded archive before copying, so partial failures are rare. If one occurs, restore from the backup in _pm-skills/backups/ or re-run the update command to retry the download.

Should contributors use this updater or git pull?▼

Contributors who cloned the repository should use git pull or git fetch and merge instead. This updater is designed for end users who installed pm-skills as a plugin or downloaded a release archive.

Related Skills

Explore More Product & Management Skills→
tianzecntianzecn
2

release

Automate version bumps, marketplace.json updates, git tagging, and release documentation for MAG Claude Plugins.

Community
Advanced
GP-SoftwareDivisionGP-SoftwareDivision

skill-authoring-workflow

Convert rough notes into compliant SKILL.md files and run validation.

Official
Advanced
mihai-dinculescumihai-dinculescu
797

release-openclaw-skill

Automates version bumping, committing, and publishing of the Tapo OpenClaw skill to ClawHub.

Community
Intermediate
real-simple-labsreal-simple-labs
44

save-brain

Automate git push and pull operations for Parker Brain repositories.

Official
Intermediate