composer-ui

Create DXOS Composer plugin UIs with design-system primitives and layout shells.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/dxos/plugins --skill composer-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: composer-ui
Source: https://github.com/dxos/plugins/tree/main/.agents/skills/composer-ui
Command: npx skills add https://github.com/dxos/plugins --skill composer-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build plugin user interfaces for DXOS Composer without fighting the design system, theme tokens, or layout conventions. It reduces rework by steering you toward the right primitives, patterns, and composition rules from the start.

Core Features & Use Cases

  • Themed UI Composition: Use Composer's @dxos/react-ui* packages for panels, cards, lists, forms, menus, icons, and dialogs.
  • Layout and Interaction Patterns: Apply the standard Panel plus ScrollArea shell, build toolbars with menu actions, and wire lists, pickers, and stack-based collections correctly.
  • Forms, Reactivity, and State: Create schema-driven forms, reactively read ECHO objects with useObject, and separate settings from view state.
  • Practical Use Case: Ideal when implementing a plugin surface such as an editor, list view, inspector, toolbar, or settings panel that must match Composer's visual and interaction standards.

Quick Start

Ask for help designing or refactoring a Composer plugin component so it uses the correct DXOS primitives, theme tokens, menu actions, and form patterns.

Frequently Asked Questions about composer-ui

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

FAQPage Schema
How do I build a React plugin UI for DXOS Composer?

Build DXOS Composer plugin UIs using @dxos/react-ui design-system primitives for panels, lists, forms, and menus. Apply the standard Panel plus ScrollArea shell and wire interactions correctly to ensure your plugin surface matches Composer's visual and interaction standards.

What is the standard layout pattern for Composer plugin components?

The standard Composer plugin layout pattern uses a Panel combined with a ScrollArea shell. Toolbars are built using menu action composition, while lists, pickers, and stack-based collections are wired following specific container and component separation rules.

How do I create schema-driven forms in DXOS Composer?

Create schema-driven forms in DXOS Composer by reactively reading ECHO objects with the useObject hook. Separate persistent settings from transient view state to maintain clean state management within your plugin surfaces.

Can I use Storybook to develop and test Composer plugin interfaces?

Storybook is supported for developing Composer plugin interfaces. You can build and isolate stories for panels, cards, lists, forms, menus, icons, and dialogs using the @dxos/react-ui packages before integrating them into the full Composer environment.

Do I need to use specific theme tokens when styling Composer plugins?

You must use specific Composer theme tokens when styling plugins to avoid visual inconsistencies. Adhering to the design-system primitives and theme tokens from @dxos/react-ui packages reduces rework and ensures your toolbar, editor, or inspector matches Composer standards.

Why does my Composer plugin component need container and component separation?

Container and component separation is required to maintain clean architecture in Composer plugins. This pattern ensures layout shells, interaction wiring, and schema-driven editing logic remain modular, making your plugin surfaces easier to refactor and maintain.