Updated today
by medusajs
medusa-agent-skills
Agent skills and commands for Medusa best practices and conventions.
230 GitHub stars (230)
+5 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | +1 |
| Oct 7 | −1 |
| Oct 8 | +2 |
| Oct 9 | +1 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | +2 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 18 skills (18 skills found in its SKILL.md files)
- 29 forks (29 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add medusajs/medusa-agent-skills
Asks which skills and agents to install. Just one: npx skills add medusajs/medusa-agent-skills --skill storefront-best-practices — add -g for every project.
Claude Code
git clone https://github.com/medusajs/medusa-agent-skillscp -r "medusa-agent-skills/plugins/ecommerce-storefront/skills/storefront-best-practices" ~/.claude/skills/
Copies the storefront-best-practices skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add medusajs/medusa-agent-skills
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
storefront-best-practices
ALWAYS 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 adding checkout, implementing cart, integrating Medusa backend, or building any ecommerce functionality. Framework-agnos…
plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md on GitHub (opens in a new tab) -
learning-medusa
Load 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 and verification.
plugins/learn-medusa/skills/learning-medusa/SKILL.md on GitHub (opens in a new tab) -
mcloud-auth
Execute 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.
plugins/medusa-cloud/skills/mcloud-auth/SKILL.md on GitHub (opens in a new tab) -
mcloud-deployments
Execute 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.
plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md on GitHub (opens in a new tab) -
mcloud-environments
Execute 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.
plugins/medusa-cloud/skills/mcloud-environments/SKILL.md on GitHub (opens in a new tab) -
mcloud-local
Execute 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 Git repo.
plugins/medusa-cloud/skills/mcloud-local/SKILL.md on GitHub (opens in a new tab) -
mcloud-logs
Execute 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.
plugins/medusa-cloud/skills/mcloud-logs/SKILL.md on GitHub (opens in a new tab) -
mcloud-organizations
Execute 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.
plugins/medusa-cloud/skills/mcloud-organizations/SKILL.md on GitHub (opens in a new tab) -
mcloud-projects
Execute 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.
plugins/medusa-cloud/skills/mcloud-projects/SKILL.md on GitHub (opens in a new tab) -
mcloud-variables
Execute 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.
plugins/medusa-cloud/skills/mcloud-variables/SKILL.md on GitHub (opens in a new tab) -
using-medusa-cloud
Manages 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.
plugins/medusa-cloud/skills/using-medusa-cloud/SKILL.md on GitHub (opens in a new tab) -
building-admin-dashboard-customizations
Load 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 usage, and data loading patterns that MCP servers don't provide.
plugins/medusa-dev/skills/building-admin-dashboard-customizations/SKILL.md on GitHub (opens in a new tab) -
building-storefronts
Load 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 usage patterns, frontend integration, and critical rules for calling Medusa APIs.
plugins/medusa-dev/skills/building-storefronts/SKILL.md on GitHub (opens in a new tab) -
building-with-medusa
Load 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 architectural patterns, best practices, and critical rules that MCP servers don't provide.
plugins/medusa-dev/skills/building-with-medusa/SKILL.md on GitHub (opens in a new tab) -
creating-agents-in-medusa
Use 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 chat extensions. Load for any internal agent type: store operations assistant, product audit, cohort analysis, customer…
plugins/medusa-dev/skills/creating-internal-agents/SKILL.md on GitHub (opens in a new tab) -
db-generate
Generate database migrations for a Medusa module
plugins/medusa-dev/skills/db-generate/SKILL.md on GitHub (opens in a new tab) -
db-migrate
Run database migrations in Medusa
plugins/medusa-dev/skills/db-migrate/SKILL.md on GitHub (opens in a new tab) -
new-user
Create an admin user in Medusa
plugins/medusa-dev/skills/new-user/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.