Setting the issue. One moment.
Contents
Issue No. 39Medusa · Official
medusajs /medusa-agent-skills
Agent skills and commands for Medusa best practices and conventions.
18 chapters · 52 minutes · 10,686 words · 4 parts
Agent skills and commands for Medusa best practices and conventions.
18 chapters · 52 minutes · 10,686 words · 4 parts
18 chapters · 52 min
npx skills add medusajs/medusa-agent-skills/plugin marketplace add medusajs/medusa-agent-skillsA collection of skills composed as Claude Code plugins for building Medusa applications with best practices and architectural patterns.
These skills can be used with any agent, as explained in the Usage with Other Agents section.
| Plugin | Description |
|---|---|
| medusa-dev (opens in a new tab) | Comprehensive skills for building Medusa applications across backend, admin UI, and storefronts. |
main, last pushed 6 August 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: plugins/ecommerce-storefront/skills/*/SKILL.md, plugins/learn-medusa/skills/*/SKILL.md, plugins/medusa-cloud/skills/*/SKILL.md, plugins/medusa-dev/skills/*/SKILL.md.h1 and no skipped levels:| learn-medusa (opens in a new tab) | Interactive tutorial session to learn about Medusa concepts through building a brands feature. |
| ecommerce-storefront (opens in a new tab) | Comprehensive skill for building high-converting ecommerce storefronts with best practices. |
| medusa-cloud (opens in a new tab) | Skills for managing Medusa Cloud resources through the Cloud CLI (mcloud). |
claude/plugin marketplace add medusajs/medusa-agent-skills/plugin install medusa-dev@medusa/pluginYou should see the Medusa plugin listed under the Installed tab.
The skills command allows you to copy skills from a repository to the directory relevant for your agent. Use this command when you only want to copy skills, as you can’t copy the MCP server with this command.
yarn skills add medusajs/medusa-agent-skillsAlternatively, you can copy the assets necessary, including skills and MCP servers, to the directory relevant to your agent.
For example, if you’re using Cursor and you want to use the medusa-dev plugin (opens in a new tab), you can:
These plugins will help you with your Medusa development. Refer to each plugin for more details on usage.
The Medusa plugins do not collect, store, or transmit any user data or conversation information. All instructional content is provided locally through skill files, and MCP servers only query public Medusa documentation.
.claude-plugin/marketplace.json by Medusa, declaring 4 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./medusajs/medusa-agent-skills.md, and each chapter at its own .md URL.