building-admin-dashboard-customizations
Load automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation). REQUIRED for all admin UI work in ALL modes (planning, implementation, exploration). Contains design patterns, component usage, and data loading patterns that MCP servers don't provide.
Security Assessment
Detected risks:
About building-admin-dashboard-customizations
The building-admin-dashboard-customizations skill provides guidance and implementation patterns for extending the Medusa Admin dashboard with custom UI functionality. It is designed to support developers working on widgets, admin pages, forms, tables, navigation flows, and dashboard integrations within the Medusa ecosystem. The skill focuses on solving common challenges in admin interface development by supplying established architectural patterns, SDK configuration requirements, and implementation rules that are not fully covered by external documentation sources. It also defines when related skills, such as backend API development or storefront customization, should be used alongside admin dashboard work.
The skill includes structured guidance for building custom dashboard experiences using the Medusa Admin SDK and Medusa UI components. It emphasizes critical implementation practices such as loading task-specific reference files before coding, using proper data loading strategies, following navigation and typography conventions, and applying recommended display and selection patterns for tables and lists. It also includes strict SDK client configuration requirements and dependency management instructions for pnpm users, including version alignment for packages such as React Query and React Router DOM. The documentation highlights correct versus incorrect development patterns and clarifies the distinction between admin UI routes and backend API routes.
This skill is intended for frontend developers, full-stack developers, and technical teams building custom administrative workflows in Medusa-based applications. Typical use cases include creating custom product or order management interfaces, building internal operational dashboards, implementing forms and modals for administrative actions, and adding navigation between custom admin pages. It is particularly valuable during planning, exploration, and implementation phases where architectural consistency and adherence to Medusa dashboard conventions are important.
FAQ
When should this skill be used?
This skill should be used for any Medusa Admin dashboard UI development task, including widgets, custom pages, forms, tables, lists, modals, and navigation features.
Does this skill replace the MedusaDocs MCP server?
No. This skill is intended to be the primary source for planning, implementation patterns, and best practices, while the MedusaDocs MCP server should be used as a secondary reference for component props, widget zones, SDK methods, and configuration details.
Are additional reference files required before implementation?
Yes. The skill explicitly requires loading relevant reference files such as forms, data-loading, display-patterns, navigation, or typography references depending on the task being implemented.
Are there package management requirements for pnpm users?
Yes. pnpm users must install peer dependencies such as @tanstack/react-query and react-router-dom using the exact versions used by the Medusa dashboard before writing code.
Can this skill be used for storefront development?
No. Storefront development should use the separate building-storefronts skill, while backend API routes should use the building-with-medusa skill.
Install building-admin-dashboard-customizations
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
medusajs/medusa-agent-skills