OpenSkillIndex← back to search
claude-codedevops

Storybook canary

Triggers a canary release for a Storybook PR. Use when the user wants to publish a canary version, create a pre-release, or test a PR via npm.

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/canary" ~/.claude/skills/storybookjs-storybook-canary && rm -rf "$T"
manifest: .agents/skills/canary/SKILL.md
tags
#npm#github-actions#release-management#versioning#automation#cli
source content

Publish Canary Release

Publishes a canary version of Storybook from a PR to npm.

Usage

To trigger a canary release, run:

gh workflow run --repo storybookjs/storybook publish.yml --field pr=<PR_NUMBER>

What happens

  1. GitHub Actions builds and publishes the PR as 
    0.0.0-pr-<PR_NUMBER>-sha-<SHORT_SHA>
  2. The version is published to npm with the 
    canary
    tag
  3. The PR body is updated with the exact version and install instructions

Version format

The canary version follows a predictable structure:

0.0.0-pr-<PR_NUMBER>-sha-<SHORT_SHA>

  • <PR_NUMBER>
    : The PR number (e.g., 
    33526
    )
  • <SHORT_SHA>
    : First 8 characters of the commit SHA (e.g., 
    a2e09fa2
    )

Example: For PR #33526 with commit 

a2e09fa284a...
, the canary version is: 
0.0.0-pr-33526-sha-a2e09fa2

You can construct the version yourself if you know the PR number and the latest commit SHA on that PR.

After publishing

Check the PR body for the published version. It will show something like:

This pull request has been released as version 

0.0.0-pr-33365-sha-b6656566

Then test with:

npx storybook@<VERSION_FROM_PR> sandbox

Or upgrade an existing project:

npx storybook@<VERSION_FROM_PR> upgrade

Requirements

  • You must have admin permissions on the storybookjs/storybook repo
  • The PR must exist and be open
  • You need 
    gh
    CLI authenticated

Monitor progress

Watch the workflow run at: https://github.com/storybookjs/storybook/actions/workflows/publish.yml