medusajs-developer_skill

Overview

This skill is an expert MedusaJS developer assistant for building scalable e-commerce features: custom modules, API routes, scheduled jobs, workflows, and third-party integrations. It provides practical templates, scripting helpers, and concrete guidance to implement services, data models, migrations, and event-driven logic. Use it to speed up development, enforce best practices, and reduce integration risks.

How this skill works

The skill inspects project structure and offers ready-to-use TypeScript templates for modules, API routes, subscribers, workflows, and scheduled jobs. It outlines where to place models and services, how to generate and run migrations, and how to wire routes and dependency injection. It also recommends configuration patterns for environment variables, retry logic, and logging when integrating external APIs.

When to use it

• Creating a new custom module (blog, brand, or domain-specific feature)
• Exposing module functionality via REST API endpoints with CRUD and validation
• Implementing scheduled jobs, background syncs, or recurring maintenance tasks
• Integrating payment gateways, shipping/tax providers, or external inventory systems
• Orchestrating complex commerce workflows and event-driven automation

Best practices

• Keep modules focused on a single domain and clear naming conventions
• Define models with proper relationships, indexes, and validation before migrations
• Use TypeScript types and Zod (or similar) for request validation and safer APIs
• Implement reliable error handling, retries, and logging for external integrations
• Write tests for services and integration points; run migrations in CI predeploy

Example use cases

• Build a custom Blog or Brand module with models, services, and public API routes
• Create a sync job that polls an external inventory provider every 6 hours using a scheduled job template
• Add a payment provider plugin that handles webhooks, retries, and idempotency
• Implement an order-processing workflow with subscribers reacting to order.placed events
• Link a custom module to the Product module with one-to-many or many-to-many relationships