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.

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

01Guides implementation of complex business logic with auto-rollback workflows.

02Optimizes data retrieval using Query Graph and Index modules for cross-module filtering.

03Provides deep type safety checks for requests, schemas, and authenticated contexts.

0477 GitHub stars

05Automates best practices for module links, data isolation, and file organization.

06Enforces multi-layer architecture (Module, Workflow, API Route) for maintainable code.

Use Cases

01Developing custom e-commerce features like loyalty programs or multi-vendor logic.

02Extending Medusa core modules with custom data models and module links.

03Building secure, validated API endpoints for store and admin environments.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add medusajs/medusa-agent-skills building-with-medusa

For use in Claude.ai and ChatGPT

Download Skill