# learning-medusa

An interactive tutoring skill that guides you through Medusa architecture step by step with hands-on checkpoints.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3400 installs · ★ 235
- Author: medusajs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/learn-medusa/skills/learning-medusa/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/learning-medusa

## What it does

The skill turns Claude Code into an interactive tutor for Medusa development. Instead of passively browsing docs, you build a brands feature from scratch. You write custom modules and connect them with workflows while the agent explains the architectural reasoning.

The training is split into 3 lessons lasting 45 to 60 minutes each, taking 2 to 3 hours in total. At every checkpoint, the agent reviews your code and tests endpoints with cURL. When questions exceed local instructions, it queries the MedusaDocs MCP server.

You need Node.js and an initialized Medusa project before you start. Jumping straight in without local infrastructure will fail immediately. Sessions can pause at any step and resume later.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/learning-medusa/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/learning-medusa/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/learning-medusa/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/learning-medusa/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install medusajs/medusa-agent-skills learning-medusa
```

2. **Manually: put the files in place**
- File: `.github/skills/learning-medusa/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/learn-medusa/skills/learning-medusa
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/learning-medusa/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/learn-medusa/skills/learning-medusa/SKILL.md

## When to use it
- learn the module and workflow pattern in Medusa
- link custom modules to products using module links and workflow hooks
- add custom widgets to the admin dashboard
- debug implementation errors at guided checkpoints

## Example prompts
- Teach me how to develop on Medusa step by step
- Guide me through building a custom brand feature in Medusa
- Start the interactive Medusa architecture tutorial

## Similar
- [backend-architect](https://affpapa.org/en/nevibecode/agents/backend-architect.md) — subagent · 23691 installs
- [rest-api-design](https://affpapa.org/en/nevibecode/skills/secondsky-rest-api-design.md) — skill · 586 installs
- [api-response-optimization](https://affpapa.org/en/nevibecode/skills/api-response-optimization.md) — skill · 484 installs
- [elysiajs](https://affpapa.org/en/nevibecode/skills/elysiajs.md) — skill · 14000 installs
- [microservices-patterns](https://affpapa.org/en/nevibecode/skills/microservices-patterns.md) — skill · 13176 installs
- [backend-development](https://affpapa.org/en/nevibecode/skills/backend-development.md) — skill · 2300 installs

From the same set: [medusajs/medusa-agent-skills](https://affpapa.org/en/nevibecode/by/medusajs/medusa-agent-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md