
medusajs / medusa-agent-skills
★ 195A skill package that teaches your agent 24 capabilities — every one documented and browsable below, no GitHub required · by medusajs.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Load automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation).…
8 files — installable on its own
Custom UI extensions for Medusa Admin dashboard using the Admin SDK and Medusa UI components. Load this skill FIRST for any admin UI work (planning, implementation, exploration); MCP servers provide API reference only, not design patterns or data loading strategies CRITICAL: Always use Medusa JS SDK for all API requests (never regular fetch); separate display queries from modal queries and invalidate display data after mutations Implement widgets on existing pages or create custom UI routes;...
8 files — installable on its own
Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns,…
3 files — installable on its own
SDK-first frontend integration for Medusa storefronts with React Query patterns and critical API calling rules. Always use the Medusa JS SDK for all API requests—never use regular fetch(), as it lacks required headers (publishable API key for store routes, auth for admin routes) Pass plain JavaScript objects to SDK methods; never use JSON.stringify() on body parameters, as the SDK handles serialization automatically Use useQuery for GET requests and useMutation for POST/DELETE requests,...
3 files — installable on its own
Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links,…
15 files — installable on its own
Comprehensive guide for Medusa backend architecture, workflows, and critical implementation rules. Covers six rule categories (architecture, type safety, business logic placement, imports, data access, file organization) with specific anti-patterns and enforcement checks Enforces strict layer separation: Module → Workflow → API Route → Frontend, with workflows required for all mutations and only GET/POST/DELETE HTTP methods allowed Includes critical data handling rules: prices stored as-is...
15 files — installable on its own
Generate database migrations for a Medusa module
1 file — installable on its own
Generate database migrations for Medusa modules with a single command. Wraps the npx medusa db:generate CLI command to create migration files for specified Medusa modules Accepts module name as an argument and reports migration file location, errors, and next steps Automatically suggests running npx medusa db:migrate after generation to apply migrations
1 file — installable on its own
Execute pending Medusa database migrations and report results. Runs npx medusa db:migrate via Bash to apply all pending migrations to your Medusa database Reports migration outcomes including count of applied migrations, any errors encountered, and success confirmation Designed for Medusa projects with standard npm/npx setup
1 file — installable on its own
Run database migrations in Medusa
1 file — installable on its own
Interactive step-by-step Medusa development bootcamp where you build a brands feature while learning architecture patterns. Three progressive lessons (2–3 hours total) covering modules, workflows, API routes, module links, workflow hooks, and admin UI customization Checkpoint verification after each major component tests conceptual understanding, code quality, and functionality before proceeding Treats errors as teaching opportunities; debugs together with diagnostic questions and root-cause...
22 files — installable on its own
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").…
22 files — installable on its own
Execute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment…
1 file — installable on its own
Execute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle,…
1 file — installable on its own
Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching…
1 file — installable on its own
Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving…
1 file — installable on its own
Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving…
1 file — installable on its own
Execute mcloud variables commands to list and get environment variables for a Cloud environment. Use when inspecting, reading, or exporting environment…
1 file — installable on its own
Create an admin user in Medusa
1 file — installable on its own
Create a new admin user in Medusa with email and password. Accepts email and password as command arguments to set up admin credentials Executes npx medusa user command via Bash with -e and -p flags Reports creation success, user email, errors, and next steps for admin dashboard login
1 file — installable on its own
Comprehensive guidance for building modern ecommerce storefronts with patterns, component architecture, and backend integration. Covers all storefront components: navigation, product pages, cart, checkout, and account pages across any framework (Next.js, SvelteKit, React, Vue) Includes critical accessibility patterns (aria-live for cart updates), mobile optimization (safe-area-inset, 44px touch targets), and SEO requirements (Product schema, Core Web Vitals) Provides mandatory backend SDK...
32 files — installable on its own
ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart,…
32 files — installable on its own
Manages Medusa Cloud resources through the Cloud CLI (mcloud). Use when deploying, debugging deployments, managing environments, environment variables, or any…
5 files — installable on its own
Manages Medusa Cloud resources through the Cloud CLI (mcloud). Use when deploying, debugging deployments, managing environments, environment variables, or any…
5 files — installable on its own
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.
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:
/pluginYou 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-skillsManual 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.
Install the whole package (24 skills):
npx skills add https://github.com/medusajs/medusa-agent-skillsOr install a single skill:
npx skills add https://github.com/medusajs/medusa-agent-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.