strapi-version-upgrade

Installation
SKILL.md

Strapi version upgrade

Upgrade a Strapi project to a target version. This skill enforces two hard rules:

  1. 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.
  2. Always use the @strapi/upgrade tool to perform the upgrade. Never upgrade by manually editing package.json or running npm install @strapi/strapi@x directly.

Follow the steps below in order.

Step 1 — Determine current and target versions

  1. Read the project's current Strapi version from package.json (@strapi/strapi under dependencies). If there is no Strapi project in the working directory, stop and tell the user.

  2. Determine the latest published version:

    npm view @strapi/strapi dist-tags
    

    The latest tag is the newest stable release. legacy is typically the latest v4.

Installs
112
Repository
strapi/skills
GitHub Stars
9
First Seen
Jul 17, 2026
strapi-version-upgrade — strapi/skills