drupal-storybook

Implement Storybook documentation and testing for Drupal Single Directory Components.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AJV009/drupal-devkit --skill drupal-storybook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drupal-storybook
Source: https://github.com/AJV009/drupal-devkit/tree/main/plugins/drupal-core/skills/drupal-storybook
Command: npx skills add https://github.com/AJV009/drupal-devkit --skill drupal-storybook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Standardizes how Drupal SDC components are documented and tested within Storybook, reducing ambiguity and improving reusability.

Core Features & Use Cases

  • Atomic design hierarchy organization (Atoms, Molecules, Organisms) for Storybook stories.
  • Consistent story naming, prop controls mapping, and cross-referencing with *.component.yml definitions.
  • Structural testing guidance via component stories and Page stories to serve as regression references.
  • Asset and reference material handling through references/ and assets/.

Quick Start

Set up a Storybook workflow for Drupal SDC following the patterns described in this skill.

Frequently Asked Questions about drupal-storybook

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

FAQPage Schema
How do I set up Storybook for Drupal Single Directory Components?

Storybook for Drupal SDC requires mapping your atoms, molecules, and organisms into structured stories with prop controls that directly align with your *.component.yml schema definitions.

What is the best way to organize Drupal SDC components in Storybook?

The best way to organize Drupal SDC components in Storybook is by using the atomic design hierarchy, grouping your elements into atoms, molecules, and organisms directories to standardize component documentation and reusability.

How do I map Storybook prop controls to a Drupal component.yml file?

Map Storybook prop controls to a Drupal component.yml file by ensuring your story templates require strict alignment with the schema definitions, allowing dynamic prop mapping that mirrors the SDC configuration.

Can I use Storybook page stories for Drupal component regression testing?

Yes, you can use Storybook page stories for Drupal component regression testing by creating structural testing guidance and page-level stories that serve as visual regression references for your SDC components.

Does the Drupal SDC Storybook workflow require specific asset directory handling?

The Drupal SDC Storybook workflow requires integration with references/ and assets/ directories to properly handle reference materials and component assets alongside your story templates.