storybook-manager

Manage multiple Storybook instances across git worktrees with automatic port assignment.

6|1|Updated Jan 14, 2026

Search Tags:#dev server #cross-platform #worktree #storybook #instance management

Ready to run

npx skills add https://github.com/MinBZK/storybook --skill storybook-manager

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: storybook-manager
Source: https://github.com/MinBZK/storybook/tree/main/.claude/skills/storybook-manager
Command: npx skills add https://github.com/MinBZK/storybook --skill storybook-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of managing multiple Storybook instances across worktrees, making it easier to start, stop, or check the status of your Storybook dev servers.

Core Features & Use Cases

Multi-instance Management: Start, stop, and check the status of Storybook instances with ease.
Automatic Port Assignment: storybook-manager automatically assigns unique ports to each instance, starting from 6006.
Registry: Instances are tracked in a registry for easy management.
Cross-platform Compatibility: storybook-manager works on Windows, Mac, and Linux.
Worktree Support: Each worktree can have its own Storybook instance on a unique port.

Quick Start

Start a new Storybook instance in the current directory with 'sb:start'.

Frequently Asked Questions about storybook-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I manage multiple Storybook dev servers across different git worktrees?▼

You can manage multiple Storybook dev servers across git worktrees using an automated instance manager that handles instance creation, tracks them in a registry, and assigns unique ports starting from 6006.

How does automatic port assignment work for Storybook instances?▼

Automatic port assignment for Storybook instances sequentially allocates unique ports starting from 6006 for each new instance, preventing network conflicts when running multiple dev servers simultaneously.

Can I use a Storybook instance manager on Windows, Mac, and Linux?▼

Yes, this Storybook instance management approach is fully cross-platform compatible, meaning the scripts to start, stop, and check dev server status function natively on Windows, Mac, and Linux.

Do I need to install Storybook separately in each git worktree?▼

Yes, you must install Storybook directly in each git worktree before running the instance manager, because the automation handles the dev servers and port routing but does not provision the Storybook framework itself.

What is the best way to check the status of running Storybook instances?▼

The best way to check the status of running Storybook instances is to use a registry-based manager that tracks all active dev servers, allowing you to query their operational state and stop them as needed.

Why do my Storybook instances conflict when running multiple worktrees?▼

Storybook instances conflict because multiple worktrees attempt to bind to the default port 6006, an issue resolved by using an instance manager that automatically assigns a unique port to each worktree.