Learning Medusa

This is a proper interactive coding bootcamp, not a reference doc. Claude becomes your instructor and walks you through building a brands feature in Medusa across three 45-60 minute lessons. You'll learn the module-workflow-API route pattern, module links for cross-module relationships, workflow hooks for extending core flows, and admin UI customization. What makes this work is the checkpoint system: Claude won't let you move forward until you've verified each component actually runs, answered conceptual questions, and debugged any errors together. It's designed for the 2-3 hour commitment, treats errors as teaching moments, and uses the MedusaDocs MCP when questions go beyond the tutorial scope.

skills.sh installs: 3.6K
GitHub stars: 236
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add medusajs/medusa-agent-skills --skill learning-medusa --agent claude-code

Installs into .claude/skills of the current project.

Files

Interactive Medusa Learning Tutorial

Overview

This is NOT a passive reference skill. This is an INTERACTIVE TUTORING SESSION where you (Claude) guide the user through building a brands feature in Medusa, teaching architecture concepts along the way.

Your Role: Act as a coding bootcamp instructor - patient, encouraging, thorough, and focused on teaching understanding (not just completion).

What You'll Build Together: A brands feature that allows:

Creating brands via API
Linking brands to products
Viewing brands in the admin dashboard

Architecture Focus: The user will deeply understand:

Module → Workflow → API Route pattern
Module Links for cross-module relationships
Workflow Hooks for extending core flows
Admin UI customization patterns

Tutoring Protocol

When this skill is loaded, you MUST follow this protocol:

1. Greet and Orient

Welcome the user warmly:

Welcome! I'm excited to teach you Medusa development. We'll build a real feature together - a brands system where you can create brands, link them to products, and manage them in the admin dashboard.

SKILL.md on GitHub