Add release history files for Mage-OS or Magento versions by fetching package data from the upstream composer repository. Use this skill whenever the user asks to add, create, or generate history files for a Mage-OS or Magento release version (e.g. "add history files for Mage-OS 2.3.0", "add Magento 2.4.9 history", "create release history for 2.2.2"). Also use when the user mentions adding a new version to this repository's history.
Use when syncing upstream mirror content into the Mage-OS default branches across the org — e.g. "merge upstream into mage-os branches", "sync tracking branches", "merge mirror content into main/mage-os", "bring in upstream PHP 8.5 fixes".
Use when preparing a Mage-OS major/minor release (e.g. "audit branches for 3.0", "which repos have release/3.x", "what still needs merging for 2.4.9", "find repos where develop is ahead of main") and you need a snapshot of release-branch coverage across every repo in the mage-os GitHub organization.
Use when preparing a Mage-OS major/minor release and you need to open the batch of PRs that merge release/3.x (or other release branch) and unmerged develop branches into each repo's default branch — e.g. "open the release prep PRs", "create PRs for 3.0", "merge release/3.x into main everywhere", "open the develop-into-main PRs".
Use when the user asks for a Mage-OS release-prep status update to share with other maintainers — e.g. "summarize release status for Discord", "write a maintainer update", "status of 3.0 prep", "draft a status message about the release branches", or after running the branch audit / PR-prep skills and the user wants the takeaway formatted for sharing.
Analyze a Mage-OS release preview by comparing it against the previous version. Produces a full dependency diff, per-repo changelogs with PRs and contributors, and a risk assessment suitable for release notes. Use this skill whenever the user asks to analyze, compare, preview, diff, or prepare release notes for a Mage-OS version (e.g. "analyze 2.2.2 release", "what changed in 2.3.0 preview", "compare release preview", "release notes for 2.2.2", "diff 2.2.2 vs 2.2.1"). Also use when the user mentions checking or reviewing a release on preview-repo.mage-os.org.