Why do I need this skill for Medusa development?

It enforces critical architectural patterns, like using workflows for mutations and specific data access methods, that standard AI models or MCP servers might miss.

How does this skill handle cross-module data retrieval?

It guides you on when to use query.graph() for simple retrieval and query.index() for advanced filtering across linked modules.

Does this skill help with frontend development?

While focused on the backend, it provides the necessary API structures and SDK integration patterns required for frontend and admin dashboard customizations.

Why can't I use PUT or PATCH methods with this skill?

Following Medusa's best practices, all mutations should be handled via POST requests through workflows to ensure atomic operations and reliable rollbacks.

Can I use async/await inside Medusa workflows?

No, Medusa workflows must be defined using regular functions to allow the engine to parse the execution graph at load time; this skill helps you avoid that common runtime error.

Medusa Backend Development

Name: Medusa Backend Development
Author: medusajs

bymedusajs

•

E-commerce Solutions

Guides developers through building production-grade Medusa backend features using standardized architectural patterns and best practices.

About

This skill provides a comprehensive framework for developing Medusa applications, enforcing critical architectural patterns like the strict separation of modules, workflows, and API routes. It ensures deep type safety, optimizes data access via Medusa’s Query API, and enforces strict business logic placement to prevent common pitfalls in e-commerce development. By loading this skill, developers receive real-time guidance on implementing custom modules, complex workflows with rollback capabilities, and secure API routes while adhering to Medusa’s latest technical standards and file organization conventions.

Key Features

Guides implementation of complex business logic with auto-rollback workflows.
Optimizes data retrieval using Query Graph and Index modules for cross-module filtering.
Provides deep type safety checks for requests, schemas, and authenticated contexts.
77 GitHub stars
Automates best practices for module links, data isolation, and file organization.
Enforces multi-layer architecture (Module, Workflow, API Route) for maintainable code.

Use Cases

Developing custom e-commerce features like loyalty programs or multi-vendor logic.
Extending Medusa core modules with custom data models and module links.
Building secure, validated API endpoints for store and admin environments.

About

Key Features

Guides implementation of complex business logic with auto-rollback workflows.
Optimizes data retrieval using Query Graph and Index modules for cross-module filtering.
Provides deep type safety checks for requests, schemas, and authenticated contexts.
77 GitHub stars
Automates best practices for module links, data isolation, and file organization.
Enforces multi-layer architecture (Module, Workflow, API Route) for maintainable code.

Use Cases

Developing custom e-commerce features like loyalty programs or multi-vendor logic.
Extending Medusa core modules with custom data models and module links.
Building secure, validated API endpoints for store and admin environments.