Storybook Upgrade (Storybook) — Agents

---
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
metadata:
  origin: Storybook
  internal: true
---

# 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

```bash
npx storybook@<VERSION> upgrade
```

## Examples

### Upgrade to canary version

```bash
npx --yes --allow-remote=all https://pkg.pr.new/storybook@<SHA> upgrade
```

### Upgrade to latest stable

```bash
npx storybook@latest upgrade
```

### Upgrade to specific release

```bash
npx storybook@8.5.0 upgrade
```

## What it does

1. Detects all `@storybook/*` packages in your project
2. Upgrades them all to the specified version
3. Handles peer dependencies automatically
4. 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)