Development
Plugin
medusa-agent-skills
A 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 Signal80/100Strong
maintained98
capable62
documented100
adopted49
Install on Claude Code
> /plugin marketplace add medusajs/medusa-agent-skills
Stats
208
Stars
26
Forks
Active
Maintenance
JavaScript
Language
3d ago
Last commit
6mo ago
Created
Repo: medusajs/medusa-agent-skills
In this plugin
- skills
- storefront-best-practices
- learning-medusa
- mcloud-auth
- mcloud-deployments
- mcloud-environments
- mcloud-local
- mcloud-logs
- mcloud-organizations
- mcloud-projects
- mcloud-variables
- using-medusa-cloud
- building-admin-dashboard-customizations
- building-storefronts
- building-with-medusa
- creating-internal-agents
- db-generate
- db-migrate
- new-user
- MCP
What's inside
Skills
18/storefront-best-practicesALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for/learning-medusaLoad automatically when user asks to learn Medusa development (e.g., "teach me how to build with medusa", "guide me through medusa", "I want to learn medusa"). Interactive guided tutorial where Claude acts as a coding bootcamp instructor, teaching step-by-step with checkpoints/mcloud-authExecute mcloud authentication and context commands: login, logout, whoami, use, version, and signup. Use when setting up the CLI, switching accounts, verifying auth state, setting the active org/project/environment context, or checking the CLI version./mcloud-deploymentsExecute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment status, or reading build output for debugging build failures./mcloud-environmentsExecute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle, redeploying after variable changes, or starting new builds from source./mcloud-localExecute mcloud local build to reproduce a Cloud build on the local machine. Use when debugging a build-failed deployment without pushing to the tracked branch, iterating on a build fix, or testing build-variable changes locally. Requires Docker and must run inside the project's
Show all 18 skillsShow fewer
/mcloud-logsExecute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment./mcloud-organizationsExecute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving organization details including members and subscription./mcloud-projectsExecute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving project details including linked environments./mcloud-variablesExecute mcloud variables commands to list, get, set, and delete environment variables for a Cloud environment. Use when inspecting, reading, creating, updating, deleting, or exporting environment variables. Never pass --reveal unless the user explicitly requests secret values./using-medusa-cloudManages Medusa Cloud resources through the Cloud CLI (mcloud). Use when deploying, debugging deployments, managing environments, environment variables, or any Medusa Cloud operation. CRITICAL for mcloud commands, deployment failures, build logs, Cloud setup, and CI/CD workflows./building-admin-dashboard-customizationsLoad automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation). REQUIRED for all admin UI work in ALL modes (planning, implementation, exploration). Contains design patterns, component/building-storefrontsLoad automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). REQUIRED for all storefront development in ALL modes (planning, implementation, exploration). Contains SDK/building-with-medusaLoad automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links, business logic). REQUIRED for all Medusa backend work in ALL modes (planning, implementation, exploration). Contains/creating-internal-agentsUse when building an internal admin-facing AI agent in a Medusa project. These agents are operated by merchants and store operators — not customers. Covers data models, module service, agent runtime (tools, system prompt, streamText), streaming API routes (NDJSON), and admin UI/db-generateGenerate database migrations for a Medusa module/db-migrateRun database migrations in Medusa/new-userCreate an admin user in Medusa
MCP
1README
1Medusa Agent Skills
A 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.
- Available Plugins
- Installation for Claude Code
- Usage
- Usage with Other Agents
- Privacy
Available Plugins
| Plugin | Description |
|---|---|
| medusa-dev | Comprehensive skills for building Medusa applications across backend, admin UI, and storefronts. |
| learn-medusa | Interactive tutorial session to learn about Medusa concepts through building a brands feature. |
| ecommerce-storefront | Comprehensive skill for building high-converting ecommerce storefronts with best practices. |
| medusa-cloud | Skills for managing Medusa Cloud resources through the Cloud CLI (mcloud). |
Installation for Claude Code
- Start Claude:
claude
- Add the Medusa marketplace to Claude Code:
/plugin marketplace add medusajs/medusa-agent-skills
- Install any of the plugins. For example:
/plugin install medusa-dev@medusa
- Verify the plugin is loaded:
/plugin
You should see the Medusa plugin listed under the Installed tab.
Usage with Other Agents
Installation with skills
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-skills
Manual Installation
Alternatively, 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, you can:
- Copy the skills directories to the .cursor/skills directory of your Medusa project.
- Add the MCP server configuration to the .cursor/mcp.json file of your Medusa project.
Usage
These plugins will help you with your Medusa development. Refer to each plugin for more details on usage.
Privacy
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.
File tree
112medusajs/medusa-agent-skillsView on GitHub
.claude-plugin/
marketplace.json
.github/
prompts/
sync-medusa-docs-changes.md
workflows/
skills-stats-to-posthog.yml
sync-medusa-docs-changes.yml
.gitignore
plugins/
ecommerce-storefront/
.claude-plugin/
plugin.json
README.md
skills/
storefront-best-practices/
reference/
components/
breadcrumbs.md
cart-popup.md
country-selector.md
footer.md
hero.md
megamenu.md
navbar.md
popups.md
product-card.md
product-reviews.md
product-slider.md
search.md
connecting-to-backend.md
design.md
features/
promotions.md
wishlist.md
layouts/
account.md
cart.md
checkout.md
home-page.md
order-confirmation.md
product-details.md
product-listing.md
static-pages.md
medusa.md
mobile-responsiveness.md
seo.md
SKILL.md
learn-medusa/
.claude-plugin/
plugin.json
.mcp.json
README.md
skills/
learning-medusa/
architecture/
admin-integration.md
module-isolation.md
module-workflow-route.md
workflow-orchestration.md
checkpoints/
checkpoint-api-route.md
checkpoint-module-links.md
checkpoint-module.md
checkpoint-querying.md
checkpoint-ui-route.md
checkpoint-widget.md
checkpoint-workflow-hooks.md
checkpoint-workflow.md
lessons/
lesson-1-custom-features.md
lesson-2-extend-medusa.md
lesson-3-admin-dashboard.md
SKILL.md
troubleshooting/
common-errors.md
verification-guide.md
medusa-cloud/
.claude-plugin/
plugin.json
README.md
skills/
mcloud-auth/
SKILL.md
mcloud-deployments/
SKILL.md
mcloud-environments/
SKILL.md
mcloud-local/
SKILL.md
mcloud-logs/
SKILL.md
mcloud-organizations/
SKILL.md
mcloud-projects/
SKILL.md
mcloud-variables/
SKILL.md
using-medusa-cloud/
reference/
debugging-deployments.md
environments-and-variables.md
setup.md
SKILL.md
medusa-dev/
.claude-plugin/
plugin.json
.mcp.json
README.md
skills/
building-admin-dashboard-customizations/
references/
data-loading.md
display-patterns.md
forms.md
navigation.md
table-selection.md
typography.md
SKILL.md
building-storefronts/
references/
frontend-integration.md
SKILL.md
building-with-medusa/
reference/
api-routes.md
authentication.md
custom-modules.md
data-models.md
error-handling.md
frontend-integration.md
module-links.md
querying-data.md
scheduled-jobs.md
subscribers-and-events.md
troubleshooting.md
workflow-hooks.md
workflows.md
SKILL.md
creating-internal-agents/
reference/
admin-extension.md
agent-setup.md
api-route.md
data-models.md
medusa-exec.md
service.md
streaming.md
SKILL.md
db-generate/
SKILL.md
db-migrate/
SKILL.md
new-user/
SKILL.md
README.md
scripts/
bump-versions.mjs
resolve-docs-commit.mjs
skills-stats-to-posthog.mjs
validate-skills.mjsFAQ
medusa-agent-skills is a Claude Code plugin with 18 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes storefront-best-practices, learning-medusa, mcloud-auth. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is medusa-agent-skills?
- A 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.
- How do I install medusa-agent-skills?
- Run these in Claude Code: /plugin marketplace add medusajs/medusa-agent-skills. Then prompt normally.
- Does medusa-agent-skills auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is medusa-agent-skills free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.