Storybook storybook-upgrade

Upgrade Storybook to a specific version (canary or release). Use this when upgrading Storybook packages in an external app, reproduction, or test project.

install

source · Clone the upstream repo

git clone https://github.com/storybookjs/storybook

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/storybookjs/storybook "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/storybook-upgrade" ~/.claude/skills/storybookjs-storybook-storybook-upgrade && rm -rf "$T"

manifest: .agents/skills/storybook-upgrade/SKILL.md

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)