medusa-ui-conformance

Enforce UI conformance between Mercur dashboards and Medusa UI components.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/OZVE/cuarta-avenida --skill medusa-ui-conformance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: medusa-ui-conformance
Source: https://github.com/OZVE/cuarta-avenida/tree/main/.claude/skills/medusa-ui-conformance
Command: npx skills add https://github.com/OZVE/cuarta-avenida --skill medusa-ui-conformance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mercur dashboards risk drifting from Medusa UI patterns, leading to inconsistent UX, accessibility gaps, and maintenance burden. This skill enforces UI conformance to ensure a cohesive, accessible experience across admin and vendor interfaces.

Core Features & Use Cases

  • Enforces use of local wrappers and established patterns before introducing new UI primitives.
  • Recommends Medusa UI components as the default for common UI elements, with Radix UI only as a genuine gap filler.
  • Provides guardrails for accessibility, keyboard navigation, internationalization, and testability across dashboards.

Use Case: When proposing a new modal or dropdown in the Mercur admin, apply this skill to determine if an existing wrapper suffices or if a new primitive is warranted to preserve consistency.

Quick Start

Assess a new or modified Mercur dashboard UI component against Medusa UI patterns and apply the prescribed wrappers or primitives.

Frequently Asked Questions about medusa-ui-conformance

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

FAQPage Schema
How do I enforce Medusa UI patterns in Mercur dashboards?

To enforce UI conformance, prioritize local wrappers and use @medusajs/ui components as the default for reusable UI, overlays, menus, and forms before creating custom primitives, ensuring consistent dashboard UX.

When should I use Radix UI instead of Medusa UI components?

Use Radix UI only to fill genuine gaps when @medusajs/ui lacks a suitable primitive for your dashboard, ensuring you maintain UI conformance and avoid unnecessary component duplication.

What is the best way to add interactive primitives to a Mercur admin dashboard?

The best way to add interactive primitives is by assessing existing local wrappers first, then defaulting to @medusajs/ui components, and only introducing custom or Radix UI elements if a genuine functional gap exists.

Does adding custom UI components affect accessibility in Mercur dashboards?

Adding custom UI components can risk accessibility gaps and UI drift. Enforcing UI conformance provides guardrails for keyboard navigation, internationalization, and testability to maintain a cohesive accessible experience.

Can I use custom dropdowns and modals without breaking Mercur dashboard consistency?

You can use custom dropdowns and modals without breaking consistency by applying UI conformance rules to determine if an existing local wrapper suffices or if a new primitive is genuinely warranted.