AI Engineering Project Tutor
rohitg00/ai-engineering-from-scratch
Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.
Interactive tutorial where the agent teaches Medusa development by guiding you through building a brands feature, with lessons and verification checkpoints.
Install Learning Medusa
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install medusajs/medusa-agent-skills learning-medusa --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .claude/skills/learning-medusa && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .claude/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusaType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install medusajs/medusa-agent-skills learning-medusa --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .agents/skills/learning-medusa && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .agents/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install medusajs/medusa-agent-skills learning-medusa --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .cursor/skills/learning-medusa && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .cursor/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/medusajs/medusa-agent-skills.git --path plugins/learn-medusa/skills/learning-medusa--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install medusajs/medusa-agent-skills learning-medusa --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .gemini/skills/learning-medusa && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .gemini/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install medusajs/medusa-agent-skills learning-medusaInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .github/skills/learning-medusa && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .github/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install medusajs/medusa-agent-skills learning-medusa --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/learn-medusa/skills/learning-medusa .opencode/skills/learning-medusa && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "learning-medusa" agent skill from https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/learn-medusa/skills/learning-medusa into .opencode/skills/learning-medusa/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "learning-medusa", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
learning-medusa- GitHub stars
- 228
- Token cost
- ~4.1k tokens
- SKILL.md length
- 1,500 words
- Files
- 18
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- None found
At a glance
Interactive tutorial where the agent teaches Medusa development by guiding you through building a brands feature, with lessons and verification checkpoints.
- Works in 12 steps: Greet and Orient → Check Prerequisites → Present Lesson Overview → …
- Learning Medusa development from scratch with a guided build
- SKILL.md covers Overview, Tutoring Protocol, Three-Lesson Structure and Checkpoint Verification Pattern, plus 3 more sections
- Calls git
What it does
This is a tutoring session rather than a reference. The agent plays a patient coding bootcamp instructor while you build a brands feature that creates brands through the API, links them to products and shows them in the admin dashboard. Along the way it teaches the module, workflow and API route pattern, module links between modules, workflow hooks that extend core flows and admin UI customization.
The protocol is greet and orient, check prerequisites such as an initialized Medusa project and a ready environment, preview each lesson, then guide in small steps: explain, implement together, verify. After each major piece it asks verification questions, reviews your code, tests with you and debugs errors using a troubleshooting guide, moving on only when a step works. The folder holds architecture notes, checkpoint files, three lessons and a common-errors guide.
When your agent uses it
- Learning Medusa development from scratch with a guided build
- Understanding how modules, workflows and API routes fit together in Medusa
- Practicing Medusa admin dashboard customization with checkpoints
Example prompts
- “Teach me how to build with Medusa.”
- “Guide me through creating a brands module and linking it to products.”
- “I want to learn Medusa, so start the tutorial and check my setup first.”
Requirements
- A Medusa project, or willingness to initialize one
- Node.js and a database for local development
Workflow steps
12 steps, taken from the step headings in SKILL.md.
- Greet and Orient
- Check Prerequisites
- Present Lesson Overview
- Guide Step-by-Step
- Verify at Checkpoints
- Teach Architecture
- Handle Errors as Teaching Opportunities
- Answer Questions with MCP
- Ask Verification Questions
- Review Code
- Test Together
- Diagnose Errors
What it can do on your machine
Read from SKILL.md and the folder at commit 066132d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Learning Medusa loads about 4.1k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 1,500 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 1,500 words (~4,135 tokens).
“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.”
- name
- learning-medusa
Files
SKILL.md and 17 other files in plugins/learn-medusa/skills/learning-medusa of medusajs/medusa-agent-skills.
- SKILL.md
- architecture/admin-integration.md
- architecture/module-isolation.md
- architecture/module-workflow-route.md
- architecture/workflow-orchestration.md
- checkpoints/checkpoint-api-route.md
- checkpoints/checkpoint-module-links.md
- checkpoints/checkpoint-module.md
- checkpoints/checkpoint-querying.md
- checkpoints/checkpoint-ui-route.md
- checkpoints/checkpoint-widget.md
- checkpoints/checkpoint-workflow-hooks.md
- checkpoints/checkpoint-workflow.md
- lessons/lesson-1-custom-features.md
- lessons/lesson-2-extend-medusa.md
- lessons/lesson-3-admin-dashboard.md
- troubleshooting/common-errors.md
- … and 1 more
Open the folder on GitHubat commit 066132d
Compare with similar skills
Learning Medusa next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Learning Medusa this skillmedusajs/medusa-agent-skills | 228 | — | ~4.1k | Automated safety check: Pass | None | |
| AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch | 66k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill | 1.3k | — | ~13k | Automated safety check: Pass | None | |
| AI Engineering Course Guiderohitg00/ai-engineering-from-scratch | 66k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Claude Academy Guideanthropics/skills | 180k | 3 repos | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Feynman Learning Cycle ClassroomTHU-MAIC/OpenMAIC | 40k | — | ~955 | Automated safety check: Pass | MIT |
Similar skills
Hung-Yi Lee Teaching Style
voidful/hung-yi-lee-skill
Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.
AI Engineering Course Guide
rohitg00/ai-engineering-from-scratch
Routes a topic, question or bug to the exact lessons in the AI Engineering from Scratch curriculum and suggests the next command to run.
- Official
Claude Academy Guide
anthropics/skills
Adds a matching Claude Academy course, tutorial or use case to the end of an answer about learning to use Claude, but only when the match is strong.
Feynman Learning Cycle Classroom
THU-MAIC/OpenMAIC
Turns a concept or lesson material into a Feynman-style classroom where learners explain first, find their smallest gap, rebuild the idea and apply it somewhere new.
Adaptive Hint Sequence Designer
GarethManning/education-agent-skills
Generate a cascading hint sequence for a problem type, revealing progressively without giving answers.
More from medusajs/medusa-agent-skills
All 16 skills in this repoMedusa Internal Admin Agents
medusajs/medusa-agent-skills
Walks through adding an AI agent for store operators to a Medusa project: data models, module service, agent runtime, streaming API route and admin chat UI.
Medusa Cloud CLI Authentication
medusajs/medusa-agent-skills
Runs the mcloud commands for logging in, checking who is authenticated, and choosing the active organization, project and environment.
Medusa Cloud Deployments CLI
medusajs/medusa-agent-skills
Lists Medusa Cloud deployments, fetches one deployment's details and reads backend or storefront build logs through the mcloud CLI to debug failed builds.
mcloud Environments
medusajs/medusa-agent-skills
Runs mcloud environments commands to list, inspect, create, delete, redeploy or rebuild environments in Medusa Cloud projects.
Medusa Cloud Local Build
medusajs/medusa-agent-skills
Reproduces a Medusa Cloud build on your machine with mcloud local build, to debug build-failed deployments without pushing or waiting on Cloud.
Mcloud Logs
medusajs/medusa-agent-skills
Execute mcloud logs to fetch and stream runtime logs for Cloud environments.
Related
Categories
Questions about Learning Medusa
What does Learning Medusa do?
Interactive tutorial where the agent teaches Medusa development by guiding you through building a brands feature, with lessons and verification checkpoints. This is a tutoring session rather than a reference. The agent plays a patient coding bootcamp instructor while you build a brands feature that creates brands through the API, links them to products and shows them in the admin dashboard.
When should I use Learning Medusa?
Learning Medusa fits situations like: learning Medusa development from scratch with a guided build; understanding how modules, workflows and API routes fit together in Medusa; practicing Medusa admin dashboard customization with checkpoints.
How do I install Learning Medusa in Claude Code?
Run `npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a claude-code`. Or copy the skill folder (plugins/learn-medusa/skills/learning-medusa in medusajs/medusa-agent-skills) into .claude/skills/learning-medusa in your project. Claude Code loads it when a task matches its description.
How do I install Learning Medusa in Codex?
Run `npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a codex`. Or copy the skill folder (plugins/learn-medusa/skills/learning-medusa in medusajs/medusa-agent-skills) into .agents/skills/learning-medusa in your project. Codex loads it when a task matches its description.
Can I use Learning Medusa in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add medusajs/medusa-agent-skills --skill learning-medusa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/learning-medusa, .gemini/skills/learning-medusa, .github/skills/learning-medusa and .opencode/skills/learning-medusa in your project.
What does Learning Medusa need to run?
Going by SKILL.md and its folder, Learning Medusa needs the command-line tools its instructions call (git). Our summary lists: A Medusa project, or willingness to initialize one; Node.js and a database for local development.
Does Learning Medusa access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Learning Medusa safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Learning Medusa use?
No licence was found for Learning Medusa or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Learning Medusa use?
About 4.1k tokens (SKILL.md is roughly 17k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Learning Medusa?
Skills that share tags, products or a category with Learning Medusa: AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars), AI Engineering Course Guide (rohitg00/ai-engineering-from-scratch, 66k stars) and Claude Academy Guide (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Learning Medusa?
medusajs (a GitHub organization) maintains it in medusajs/medusa-agent-skills, which has 228 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.
Source: medusajs/medusa-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.