strapi-version-upgrade
Installation
SKILL.md
Strapi version upgrade
Upgrade a Strapi project to a target version. This skill enforces two hard rules:
- Always check breaking changes before upgrading. Never run the upgrade without first reviewing the breaking changes that apply between the current version and the target.
- Always use the
@strapi/upgradetool to perform the upgrade. Never upgrade by manually editingpackage.jsonor runningnpm install @strapi/strapi@xdirectly.
Follow the steps below in order.
Step 1 — Determine current and target versions
-
Read the project's current Strapi version from
package.json(@strapi/strapiunderdependencies). If there is no Strapi project in the working directory, stop and tell the user. -
Determine the latest published version:
npm view @strapi/strapi dist-tagsThe
latesttag is the newest stable release.legacyis typically the latest v4.