Learn Medusa

Learn Medusa - Interactive Tutorial Plugin

An interactive, guided tutorial for learning Medusa development from scratch by building a brands feature. Claude acts as your coding bootcamp instructor, teaching you step-by-step with checkpoints and verification.

For installation and usage with other agents, refer to the main README.

• Installation with Claude Code
  • Prerequisites
  • Install Plugin
• Installation for Other AI Agents
• Usage
• What You'll Learn
  • Lesson 1: Build Custom Features (45-60 min)
  • Lesson 2: Extend Medusa (45-60 min)
  • Lesson 3: Customize Admin Dashboard (45-60 min)
• Features
• Privacy

Installation with Claude Code

Prerequisites

• Claude Code installed
• A Medusa project (or planning to create one)

Install Plugin

1. Start Claude:

claude

1. Add Medusa marketplace to Claude Code:

/plugin marketplace add medusajs/medusa-agent-skills

1. Install the plugin:

/plugin install learn-medusa@medusa

1. Verify the plugin is loaded:

/plugin

Installation for Other AI Agents

For other AI agents like Cursor, you can use the skills command to install the plugin's skills based on your AI agent:

npx skills add medusajs/medusa-agent-skills
# choose the following skills:
# - building-with-medusa
# - building-admin-dashboard-customizations
# - building-storefronts
# - db-generate
# - db-migrate
# - new-user

Usage

Ask Claude to teach you:

• "Teach me how to build with Medusa"
• "Guide me through Medusa development"
• "I want to learn Medusa"

Claude will start an interactive tutorial where you'll build a brands feature while learning Medusa's architecture.

You can also trigger the skill manually with /learn-medusa:learning-medusa.

What You'll Learn

Lesson 1: Build Custom Features (45-60 min)

• Create a Brand Module (data model, service, migrations)
• Build a Workflow for creating brands (with rollback logic)
• Expose an API Route for creating brands (with validation)

Lesson 2: Extend Medusa (45-60 min)

• Link brands to products using Module Links
• Extend core workflows using Workflow Hooks
• Query linked data across modules

Lesson 3: Customize Admin Dashboard (45-60 min)

• Create a Widget to display brand on product page
• Build a UI Route for managing brands
• Use React Query and Medusa UI components

Features

• Interactive: Claude guides you step-by-step, verifying your work at checkpoints
• Architecture-Focused: Learn WHY, not just WHAT
• Error-Friendly: Errors are treated as teaching opportunities
• Hands-On: Build a real feature (brands) while learning
• Progressive: Start simple, build complexity gradually

Privacy

This plugin does not collect, store, or transmit any user data or conversation information. All instructional content is provided locally through skill files, and the MCP server only queries public Medusa documentation.