Strapi Version Upgrade

Upgrade a Strapi application to a new version. ALWAYS reviews the relevant breaking changes first (via the strapi-docs MCP server, or by fetching the docs directly if the MCP is unavailable), then performs the upgrade using the official @strapi/upgrade tool. Use whenever the user wants to upgrade, update, or bump their Strapi version.

9 stars 1 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add strapi/skills --skill strapi-version-upgrade
Manual install
git clone --depth 1 https://github.com/strapi/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/cms/strapi-version-upgrade ~/.claude/skills/strapi-version-upgrade

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the 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:

   ```bash
   npm view @strapi/strapi dist-tags
   ```

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

3. Establish the target. If the user named a version or release type (`major`/`minor`/`patch`/`latest`/a specific `x.y.z`), use it. Otherwise default to `latest` and confirm with the user.
4. Classify the jump using [semantic versioning](https://semver.org/): compare the major/minor/patch of current vs. target. **Only a change in the major number introduces breaking changes.** Minor and patch releases are backward-compatible by definition.

## Step 2 — Check breaking changes (MANDATORY, before any upgrade)
Read the full skill on GitHub

Details

Skill name
strapi-version-upgrade
Repository
strapi/skills
Path
skills/cms/strapi-version-upgrade/SKILL.md
Repo updated
1 November 2026

FAQ

What does the Strapi Version Upgrade skill do?

Upgrade a Strapi application to a new version. ALWAYS reviews the relevant breaking changes first (via the strapi-docs MCP server, or by fetching the docs directly if the MCP is unavailable), then performs the upgrade using the official @strapi/upgrade tool. Use whenever the user wants to upgrade, update, or bump their Strapi version.

How do I install the Strapi Version Upgrade skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add strapi/skills --skill strapi-version-upgrade. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Strapi Version Upgrade popular?

It lives in strapi/skills, which has 9 GitHub stars and 1 forks.

Related skills

Strapi Docs MCP

9

strapi/skills

Query the official Strapi documentation through the strapi-docs MCP server (powered by Kapa). Use for any Strapi question — API syntax, configuration, features, plugins, upgrades, CLI. If the server is missing, instruct the user how to install it.

Writing & Content

Strapi MCP Capabilities

9

strapi/skills

Create custom MCP capabilities (tools, prompts, resources) in a Strapi 5 plugin via the strapi.ai.mcp service. Use when adding a custom MCP tool/prompt/resource to Strapi, extending the Strapi MCP server.

AI, LLMs & Agents

Strapi Product Builder

9

strapi/skills

Run a structured, business-value-first product-planning interview that turns a fuzzy idea into a build-ready spec — BEFORE any code is written. Use this the moment someone is still figuring out WHAT to build and says things like "I have an idea for an app, help me think it through", "help me plan/scope/design my product", "where do I start?", "let's spec this out before I write code", or "turn this into a PRD". Covers any new app, site, SaaS, MVP, marketplace, or feature. Trigger on the planning intent alone — the user need NOT mention Strapi, a CMS, or any tech; a Strapi v5 + Strapi Cloud bac

Productivity & Notes

Tender Writer

6

Hugin-Z/tender-writer-v3

政府类项目投标文件(技术标)编制专家。当用户上传招标文件、招标公告,或提到投标、技术标、响应文件、评分办法、废标条款、实质性响应、政府采购、竞争性磋商等关键词时触发。本 skill 严格按照"招标文件解析→评分矩阵构建→提纲生成→分章节撰写→合规终审"五阶段主干 + 并列阶段(4-B/4-C/6)工作流推进,确保每一分都对应到具体应答内容,杜绝漏答、错答、废标风险。适用于政府机关、事业单位、国有企业的信息化、智慧城市、数字乡村、政务系统等技术标编制场景。

Writing & Content

Tomique Linkedin Copywriter

9

tomique34/claude-skill-creator

Create engaging LinkedIn posts in Tomáš Vince's personal writing style for Cloud Architecture, IoT, AI automation topics. Supports Slovak and English, converts article URLs or experiences into professional, human-sounding posts with hooks, insights, and CTAs. Use when creating LinkedIn content that sounds authentic, motivational, and thought-leadership oriented.

Writing & Content

API Docs Generator

9

tomique34/claude-skill-creator

Generate comprehensive API documentation from OpenAPI specs, code docstrings, JSDoc/TSDoc comments, and Markdown annotations. Use when creating or updating API documentation in /docs/API.md from various source formats including Swagger, Python docstrings, TypeScript interfaces, or inline comments.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.