Medusa
Medusa is an open-source e-commerce platform that enables developers to build and customize their online stores with a flexible architecture and a robust backend.
Featured Skills
Build ecommerce applications with Medusa v2 - commerce modules, customization, workflows, and deployment
ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for adding checkout, implementing cart, integrating Medusa backend, or building any ecommerce functionality. Framework-agnostic (Next.js, SvelteKit, TanStack Start, React, Vue). Provides patterns, decision frameworks, backend integration guidance.
Load automatically when user asks to learn Medusa development (e.g., "teach me how to build with medusa", "guide me through medusa", "I want to learn medusa"). Interactive guided tutorial where Claude acts as a coding bootcamp instructor, teaching step-by-step with checkpoints and verification.
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.
Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). REQUIRED for all storefront development in ALL modes (planning, implementation, exploration). Contains SDK usage patterns, frontend integration, and critical rules for calling Medusa APIs.
Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links, business logic). REQUIRED for all Medusa backend work in ALL modes (planning, implementation, exploration). Contains architectural patterns, best practices, and critical rules that MCP servers don't provide.
Specialized agent for MedusaJS development including custom modules, API routes, data models, workflows, scheduled jobs, and third-party integrations. Provides expert guidance on commerce platform architecture and plugin development.
Creates custom MedusaJS v2 plugins following the established patterns from the Bling plugin. Guides through plugin structure creation including modules, models, API routes, workflows, and TypeScript configuration. Use when creating new MedusaJS integrations, third-party service plugins, or extending MedusaJS functionality with custom modules.
Medusa.js workflow intelligence. Returns processing, refunds, order management, e-commerce workflows. Actions: design, implement, search, generate, review, optimize, debug, structure, architect, refactor workflow code. Components: workflow steps, compensation logic, hooks, modules, services, API routes, subscribers. Patterns: idempotent steps, reversible workflows, long-running tasks, saga pattern, error handling, retry logic. Topics: Medusa.js, workflow API, step functions, module architecture, database transactions, event-driven design, TypeScript, PostgreSQL, Redis. (project)
Build blazing fast e-commerce storefronts using MedusaJS as headless backend and Astro for static-first rendering with React islands. Triggers on requests for MedusaJS frontends, Astro e-commerce, headless commerce with static generation, or performance-optimized storefronts.
Lead Ecommerce Engineer specializing in Medusa.js backend logic, architecture, and Postgres performance optimization. Use when the user asks to implement Medusa.js services, entities, API routes, or complex Postgres queries, or asks for backend performance optimizations.
Experts-level management of Medusa products. Guides the search, creation, and update of products, variants, and categories using MCP tools. Documents metadata structure for laptop technical specifications and SEO fields.