learning-medusa

The learning-medusa skill is an interactive, guided tutorial in which the agent acts as a coding bootcamp instructor, teaching Medusa e-commerce development step by step rather than serving as a passive reference. Together with the user it builds a real brands feature (create brands via API, link them to products, and manage them in the admin dashboard) while teaching the underlying architecture.

It follows a structured tutoring protocol: greet and orient, check prerequisites, present lesson overviews, guide implementation with an explain-then-do-then-verify rhythm, and verify understanding at checkpoints before proceeding. The curriculum spans three lessons covering the Module to Workflow to API Route pattern, extending Medusa with module links and workflow hooks plus cross-module Query, and customizing the admin dashboard with widgets and UI routes. It treats errors as teaching opportunities, leans on ASCII architecture diagrams, and queries the MedusaDocs MCP server when it needs the latest information.

It is most useful for developers who want to learn Medusa hands-on and come away understanding its architecture deeply enough to build custom features confidently.