| name | storybook-upgrade |
| description | Upgrade Storybook to a specific version (canary or release). Use this when upgrading Storybook packages in an external app, reproduction, or test project. |
| allowed-tools | Bash |
Storybook Upgrade
Upgrades all Storybook packages in a project to a specific version.
Why this matters for the monorepo
This skill is mainly for validating Storybook changes outside this repository.
- QA a canary build from a Storybook PR in a downstream app
- Reproduce or verify a bug in an external project
Usage
npx storybook@<VERSION> upgrade
Examples
Upgrade to canary version
npx storybook@0.0.0-pr-33526-sha-a2e09fa2 upgrade
Upgrade to latest stable
npx storybook@latest upgrade
Upgrade to specific release
npx storybook@8.5.0 upgrade
What it does
- Detects all
@storybook/* packages in your project
- Upgrades them all to the specified version
- Handles peer dependencies automatically
- Works with npm, yarn, and pnpm
Important
- DO NOT manually install storybook packages with
npm add / yarn add / pnpm add
- Always use
npx storybook@<version> upgrade to ensure all packages stay in sync
- The upgrade command handles version resolution across all storybook packages
- ALWAYS upgrade only 1 major version at a time!
- Example: 8.x → 9.x → 10.x → canary of 10
- Never skip major versions (e.g., don't go from 8.x directly to 10.x)
