pf-org-version-update

Resolve PatternFly versions and update package.json and versions.json files.

10|26|Updated Jul 8, 2025
One-click install
npx skills add https://github.com/patternfly/ai-helpers --skill pf-org-version-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pf-org-version-update
Source: https://github.com/patternfly/ai-helpers/tree/main/plugins/repo-management/skills/pf-org-version-update
Command: npx skills add https://github.com/patternfly/ai-helpers --skill pf-org-version-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updating the PatternFly org repo for new releases and release candidates is error-prone and manual; pf-org-version-update automates resolving versions, applies them to all relevant package.json files (root, documentation-site, and documentation-framework), and updates versions.json, with a clear path to run a local build and validation.

Core Features & Use Cases

  • Resolve versions from explicit user input or by scanning the repository via the included script, producing a complete set of @patternfly/* versions.
  • Update dependencies across root package.json (devDependencies and resolutions), documentation-site package.json, and documentation-framework peerDependencies, touching only PatternFly packages.
  • Insert a new top release entry in packages/documentation-framework/versions.json, mark the previous latest as hidden, and ensure all releases maintain a consistent versions map with all required packages.
  • Provide a verified workflow with steps to install, build, serve, and generate screenshots locally for validation.

Quick Start

Specify the new PatternFly versions or let the skill resolve them, then apply the generated steps to update package.json and versions.json and run a local build to verify changes.

Frequently Asked Questions about pf-org-version-update

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

FAQPage Schema
How do I update PatternFly package versions across multiple package.json files for a new release?

To update PatternFly package versions for a new release, you resolve versions from explicit input or by scanning the repository, then apply them across root, documentation-site, and documentation-framework package.json files. It updates devDependencies, resolutions, and peerDependencies.

How does versions.json stay consistent when adding a new PatternFly release entry?

When adding a new PatternFly release entry in versions.json, it inserts a new top release, marks the previous latest as hidden, and ensures all releases maintain a consistent versions map with all required packages.

What is the best way to validate PatternFly version updates locally before pushing a release?

The best way to validate PatternFly version updates locally is to run install, build, serve, and generate screenshots. It provides a verified workflow with steps to ensure changes are correct before finalizing the release.

Can I automate resolving @patternfly/* dependencies without manually specifying each version?

Yes, you can automate resolving @patternfly/* dependencies by letting the skill scan the repository via an included script. This produces a complete set of @patternfly/* versions without requiring explicit user input for every package.

Does the PatternFly version update process touch non-PatternFly packages in package.json?

No, the PatternFly version update process touches only PatternFly packages. It updates dependencies across root package.json, documentation-site, and documentation-framework peerDependencies while leaving non-PatternFly packages untouched.

Why do I need to update peerDependencies in the documentation-framework for a PatternFly release?

You need to update peerDependencies in the documentation-framework to ensure compatibility with the new PatternFly release. It updates these alongside root devDependencies and resolutions to maintain version consistency across the repository.