medusajs/medusa-agent-skills▌

Interactive step-by-step Medusa development bootcamp where you build a brands feature while learning architecture patterns. \n \n Three progressive lessons (2–3 hours total) covering modules, workflows, API routes, module links, workflow hooks, and admin UI customization \n Checkpoint verification after each major component tests conceptual understanding, code quality, and functionality before proceeding \n Treats errors as teaching opportunities; debugs together with diagnostic questions and ro

Create a new admin user in Medusa with email and password. \n \n Accepts email and password as command arguments to set up admin credentials \n Executes npx medusa user command via Bash with -e and -p flags \n Reports creation success, user email, errors, and next steps for admin dashboard login \n

Execute pending Medusa database migrations and report results. \n \n Runs npx medusa db:migrate via Bash to apply all pending migrations to your Medusa database \n Reports migration outcomes including count of applied migrations, any errors encountered, and success confirmation \n Designed for Medusa projects with standard npm/npx setup \n

Generate database migrations for Medusa modules with a single command. \n \n Wraps the npx medusa db:generate CLI command to create migration files for specified Medusa modules \n Accepts module name as an argument and reports migration file location, errors, and next steps \n Automatically suggests running npx medusa db:migrate after generation to apply migrations \n

SDK-first frontend integration for Medusa storefronts with React Query patterns and critical API calling rules. \n \n Always use the Medusa JS SDK for all API requests—never use regular fetch(), as it lacks required headers (publishable API key for store routes, auth for admin routes) \n Pass plain JavaScript objects to SDK methods; never use JSON.stringify() on body parameters, as the SDK handles serialization automatically \n Use useQuery for GET requests and useMutation for POST/DELETE reques

Comprehensive guidance for building modern ecommerce storefronts with patterns, component architecture, and backend integration. \n \n Covers all storefront components: navigation, product pages, cart, checkout, and account pages across any framework (Next.js, SvelteKit, React, Vue) \n Includes critical accessibility patterns (aria-live for cart updates), mobile optimization (safe-area-inset, 44px touch targets), and SEO requirements (Product schema, Core Web Vitals) \n Provides mandatory backen

Custom UI extensions for Medusa Admin dashboard using the Admin SDK and Medusa UI components. \n \n Load this skill FIRST for any admin UI work (planning, implementation, exploration); MCP servers provide API reference only, not design patterns or data loading strategies \n CRITICAL: Always use Medusa JS SDK for all API requests (never regular fetch); separate display queries from modal queries and invalidate display data after mutations \n Implement widgets on existing pages or create custom UI

Comprehensive guide for Medusa backend architecture, workflows, and critical implementation rules. \n \n Covers six rule categories (architecture, type safety, business logic placement, imports, data access, file organization) with specific anti-patterns and enforcement checks \n Enforces strict layer separation: Module → Workflow → API Route → Frontend, with workflows required for all mutations and only GET/POST/DELETE HTTP methods allowed \n Includes critical data handling rules: prices stored