storybook-stories

Create, update, and refactor Storybook stories for React component libraries.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/rhuangabrielsantos/skills --skill storybook-stories-rhuangabrielsantos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: storybook-stories
Source: https://github.com/rhuangabrielsantos/skills/tree/main/skills/storybook-stories
Command: npx skills add https://github.com/rhuangabrielsantos/skills --skill storybook-stories-rhuangabrielsantos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enforces consistent Storybook story patterns and documentation across a codebase to prevent fragmented examples, missing docs, improper imports, and styling inconsistencies that make component libraries hard to maintain and review.

Core Features & Use Cases

  • Import and Composition Rules: Require using base components from @compozy/ui and composing rather than recreating UI elements.
  • Meta and Story Conventions: Enforce explicit Meta typing, centered layout, docs descriptions, decorators when needed, and mandatory args: {} for every story.
  • Design System & Accessibility: Mandate design token usage, follow shadcn/react rules, and prefer render functions for compound components to preserve accessibility and composition.
  • Use Cases: Add stories for new components, refactor existing stories to match project standards, and fix Storybook-related regressions or accessibility issues.

Quick Start

Add a centered Storybook story for MyComponent that imports base components from @compozy/ui, uses design tokens, includes an explicit Meta type, and has args: {}.

Frequently Asked Questions about storybook-stories

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

FAQPage Schema
How do I enforce consistent Storybook stories across a React component library?

Standardizing Storybook stories involves enforcing explicit Meta typing, centered layout decorators, mandatory args objects, and design token usage to prevent fragmented component examples and styling inconsistencies in your React library.

How do I refactor Storybook stories to use design tokens and explicit Meta typing?

Refactoring Storybook stories requires updating existing examples to use design tokens, adding explicit Meta type definitions, ensuring mandatory args presence, and applying centered layout decorators for design-system compliance.

Does this Storybook standardization approach work for React monorepos?

Yes, this Storybook standardization approach works for React monorepos by enforcing imports from @compozy/ui, composing base components rather than recreating them, and applying consistent documentation rules across all component examples.

Why are my Storybook stories missing accessibility and design-system compliance?

Storybook stories often lack accessibility and design-system compliance when they miss mandatory args, fail to use design tokens, or do not prefer render functions for compound components to preserve composition.

What is the best way to add Storybook stories for new UI components?

The best way to add Storybook stories for new UI components is to import base elements from @compozy/ui, use design tokens, include explicit Meta typing, and ensure every story has mandatory args and a centered layout.

When should I use render functions in Storybook stories?

Use render functions in Storybook stories when working with compound components to preserve accessibility and composition, ensuring you compose base UI elements from your design system rather than recreating them.