storybook-upgrade

Source excerpt starting at line 1.

1---2name: storybook-upgrade3description: Upgrade Storybook to a specific version (canary or release). Use this when upgrading Storybook packages in an external app, reproduction, or test project.4allowed-tools: Bash5---6 7# Storybook Upgrade8 9Upgrades all Storybook packages in a project to a specific version.10 11## Why this matters for the monorepo12 13This skill is mainly for validating Storybook changes outside this repository.14 15- QA a canary build from a Storybook PR in a downstream app16- Reproduce or verify a bug in an external project17 18## Usage19 20```bash21npx storybook@<VERSION> upgrade22```23 24## Examples25 26### Upgrade to canary version27 28```bash29npx --yes --allow-remote=all https://pkg.pr.new/storybook@<SHA> upgrade30```31 32### Upgrade to latest stable33 34```bash35npx storybook@latest upgrade36```37 38### Upgrade to specific release39 40```bash41npx storybook@8.5.0 upgrade42```43 44## What it does45 461. Detects all `@storybook/*` packages in your project472. Upgrades them all to the specified version483. Handles peer dependencies automatically494. Works with npm, yarn, and pnpm50 51## Important52 53- **DO NOT** manually install storybook packages with `npm add` / `yarn add` / `pnpm add`54- Always use `npx storybook@<version> upgrade` to ensure all packages stay in sync55- The upgrade command handles version resolution across all storybook packages56- **ALWAYS upgrade only 1 major version at a time!**57  - Example: 8.x → 9.x → 10.x → canary of 1058  - Never skip major versions (e.g., don't go from 8.x directly to 10.x)59