--- title: "medusajs/medusa-agent-skills" description: "Agent skills and commands for Medusa best practices and conventions." source: https://github.com/medusajs/medusa-agent-skills ref: main license: null licenseName: "No licence detected" canonical: https://skillsdocs.com/medusajs/medusa-agent-skills base: https://github.com/medusajs/medusa-agent-skills/blob/main/ chapters: 18 inlined: 0 withheld: 18 words: 10686 updated: 2026-08-06T13:15:45Z generator: "Skills Docs" --- > **medusajs/medusa-agent-skills** — every Agent Skill in this repository, inlined verbatim. > > Canonical HTML: https://skillsdocs.com/medusajs/medusa-agent-skills > Per-chapter Markdown: https://skillsdocs.com/medusajs/medusa-agent-skills/.md > Machine manifest: https://skillsdocs.com/medusajs/medusa-agent-skills/.well-known/agent-skills/index.json > JSON: https://skillsdocs.com/api/v1/books/medusajs/medusa-agent-skills > Install: `npx skills add medusajs/medusa-agent-skills` > Upstream: https://github.com/medusajs/medusa-agent-skills @ `main` > Licence: No licence detected — all rights reserved by its authors > > Content is mirrored from GitHub and © its authors, served unmodified. Takedown: https://github.com/kyleledbetter/skillsdocs/issues/new?labels=takedown&title=Takedown+request # medusajs/medusa-agent-skills Agent skills and commands for Medusa best practices and conventions. - **Chapters:** 18 - **Inlined:** 0 (licence detected) - **Words:** 10,686 - **Reading time:** 52 min - **Stars:** 208 ## Table of contents 1. [storefront-best-practices](https://skillsdocs.com/medusajs/medusa-agent-skills/storefront-best-practices.md) — Not licensed for republication — link only. 2. [learning-medusa](https://skillsdocs.com/medusajs/medusa-agent-skills/learning-medusa.md) — Not licensed for republication — link only. 3. [mcloud-auth](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-auth.md) — Not licensed for republication — link only. 4. [mcloud-deployments](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-deployments.md) — Not licensed for republication — link only. 5. [mcloud-environments](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-environments.md) — Not licensed for republication — link only. 6. [mcloud-local](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-local.md) — Not licensed for republication — link only. 7. [mcloud-logs](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-logs.md) — Not licensed for republication — link only. 8. [mcloud-organizations](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-organizations.md) — Not licensed for republication — link only. 9. [mcloud-projects](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-projects.md) — Not licensed for republication — link only. 10. [mcloud-variables](https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-variables.md) — Not licensed for republication — link only. 11. [using-medusa-cloud](https://skillsdocs.com/medusajs/medusa-agent-skills/using-medusa-cloud.md) — Not licensed for republication — link only. 12. [building-admin-dashboard-customizations](https://skillsdocs.com/medusajs/medusa-agent-skills/building-admin-dashboard-customizations.md) — Not licensed for republication — link only. 13. [building-storefronts](https://skillsdocs.com/medusajs/medusa-agent-skills/building-storefronts.md) — Not licensed for republication — link only. 14. [building-with-medusa](https://skillsdocs.com/medusajs/medusa-agent-skills/building-with-medusa.md) — Not licensed for republication — link only. 15. [creating-agents-in-medusa](https://skillsdocs.com/medusajs/medusa-agent-skills/creating-internal-agents.md) — Not licensed for republication — link only. 16. [db-generate](https://skillsdocs.com/medusajs/medusa-agent-skills/db-generate.md) — Not licensed for republication — link only. 17. [db-migrate](https://skillsdocs.com/medusajs/medusa-agent-skills/db-migrate.md) — Not licensed for republication — link only. 18. [new-user](https://skillsdocs.com/medusajs/medusa-agent-skills/new-user.md) — Not licensed for republication — link only. ## Licence notice 18 of 18 chapters in this book have no licence that we could detect, at either the repository or the skill level. Their bodies are **not** reproduced here and they are **not** listed in the Agent Skills manifest. Read them upstream: - storefront-best-practices — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md - learning-medusa — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/learn-medusa/skills/learning-medusa/SKILL.md - mcloud-auth — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-auth/SKILL.md - mcloud-deployments — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md - mcloud-environments — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-environments/SKILL.md - mcloud-local — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-local/SKILL.md - mcloud-logs — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-logs/SKILL.md - mcloud-organizations — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-organizations/SKILL.md - mcloud-projects — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-projects/SKILL.md - mcloud-variables — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-variables/SKILL.md - using-medusa-cloud — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/using-medusa-cloud/SKILL.md - building-admin-dashboard-customizations — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/SKILL.md - building-storefronts — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-storefronts/SKILL.md - building-with-medusa — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md - creating-agents-in-medusa — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/creating-internal-agents/SKILL.md - db-generate — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/db-generate/SKILL.md - db-migrate — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/db-migrate/SKILL.md - new-user — https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/new-user/SKILL.md ## Front matter _The repository README, verbatim except that relative links are resolved against https://github.com/medusajs/medusa-agent-skills/blob/main/._ # 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](#usage-with-other-agents) section. - [Available Plugins](#available-plugins) - [Installation for Claude Code](#installation-for-claude-code) - [Usage](#usage) - [Usage with Other Agents](#usage-with-other-agents) - [Privacy](#privacy) ## Available Plugins | Plugin | Description | |--------|-------------| | [medusa-dev](https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/README.md) | Comprehensive skills for building Medusa applications across backend, admin UI, and storefronts. | | [learn-medusa](https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/learn-medusa/README.md) | Interactive tutorial session to learn about Medusa concepts through building a brands feature. | | [ecommerce-storefront](https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/ecommerce-storefront/README.md) | Comprehensive skill for building high-converting ecommerce storefronts with best practices. | | [medusa-cloud](https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/README.md) | Skills for managing Medusa Cloud resources through the Cloud CLI (mcloud). | ## Installation for Claude Code 1. Start Claude: ```bash claude ``` 2. Add the Medusa marketplace to Claude Code: ```bash /plugin marketplace add medusajs/medusa-agent-skills ``` 3. Install any of the plugins. For example: ```bash /plugin install medusa-dev@medusa ``` 4. Verify the plugin is loaded: ```bash /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. ```bash 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](https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/README.md), you can: 1. Copy the skills directories to the .cursor/skills directory of your Medusa project. 2. 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. --- ## Part: Ecommerce Storefront --- ## 1. 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-agnostic (Next.js, SvelteKit, TanStack Start, React, Vue). Provides patterns, decision frameworks, backend integration guidance. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/storefront-best-practices.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (27), referenced from this skill's directory: - `reference/components/breadcrumbs.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/breadcrumbs.md - `reference/components/cart-popup.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/cart-popup.md - `reference/components/country-selector.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/country-selector.md - `reference/components/footer.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/footer.md - `reference/components/hero.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/hero.md - `reference/components/megamenu.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/megamenu.md - `reference/components/navbar.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/navbar.md - `reference/components/popups.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/popups.md - `reference/components/product-card.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/product-card.md - `reference/components/product-reviews.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/product-reviews.md - `reference/components/product-slider.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/product-slider.md - `reference/components/search.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/components/search.md - `reference/connecting-to-backend.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/connecting-to-backend.md - `reference/design.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/design.md - `reference/features/promotions.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/features/promotions.md - `reference/features/wishlist.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/features/wishlist.md - `reference/layouts/account.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/account.md - `reference/layouts/cart.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/cart.md - `reference/layouts/checkout.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/checkout.md - `reference/layouts/home-page.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/home-page.md - `reference/layouts/order-confirmation.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/order-confirmation.md - `reference/layouts/product-details.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/product-details.md - `reference/layouts/product-listing.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/product-listing.md - `reference/layouts/static-pages.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/ecommerce-storefront/skills/storefront-best-practices/reference/layouts/static-pages.md - …and 3 more, listed in https://skillsdocs.com/api/v1/books/medusajs/medusa-agent-skills/skills/storefront-best-practices _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## Part: Learn Medusa --- ## 2. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/learn-medusa/skills/learning-medusa/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/learning-medusa.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (17), referenced from this skill's directory: - `architecture/admin-integration.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/architecture/admin-integration.md - `architecture/module-isolation.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/architecture/module-isolation.md - `architecture/module-workflow-route.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/architecture/module-workflow-route.md - `architecture/workflow-orchestration.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/architecture/workflow-orchestration.md - `checkpoints/checkpoint-api-route.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-api-route.md - `checkpoints/checkpoint-module-links.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-module-links.md - `checkpoints/checkpoint-module.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-module.md - `checkpoints/checkpoint-querying.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-querying.md - `checkpoints/checkpoint-ui-route.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-ui-route.md - `checkpoints/checkpoint-widget.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-widget.md - `checkpoints/checkpoint-workflow-hooks.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-workflow-hooks.md - `checkpoints/checkpoint-workflow.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/checkpoints/checkpoint-workflow.md - `lessons/lesson-1-custom-features.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/lessons/lesson-1-custom-features.md - `lessons/lesson-2-extend-medusa.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/lessons/lesson-2-extend-medusa.md - `lessons/lesson-3-admin-dashboard.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/lessons/lesson-3-admin-dashboard.md - `troubleshooting/common-errors.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/troubleshooting/common-errors.md - `troubleshooting/verification-guide.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/learn-medusa/skills/learning-medusa/troubleshooting/verification-guide.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## Part: Medusa Cloud --- ## 3. mcloud-auth - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-auth/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-auth/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-auth.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 4. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-deployments.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 5. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-environments/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-environments/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-environments.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 6. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-local/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-local/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-local.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 7. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-logs/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-logs/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-logs.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 8. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-organizations/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-organizations/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-organizations.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 9. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-projects/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-projects/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-projects.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 10. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/mcloud-variables/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/mcloud-variables/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/mcloud-variables.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 11. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-cloud/skills/using-medusa-cloud/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/using-medusa-cloud/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/using-medusa-cloud.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (3), referenced from this skill's directory: - `reference/debugging-deployments.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/using-medusa-cloud/reference/debugging-deployments.md - `reference/environments-and-variables.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/using-medusa-cloud/reference/environments-and-variables.md - `reference/setup.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-cloud/skills/using-medusa-cloud/reference/setup.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## Part: Medusa Dev --- ## 12. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/building-admin-dashboard-customizations.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (6), referenced from this skill's directory: - `references/data-loading.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/data-loading.md - `references/display-patterns.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/display-patterns.md - `references/forms.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/forms.md - `references/navigation.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/navigation.md - `references/table-selection.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/table-selection.md - `references/typography.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-admin-dashboard-customizations/references/typography.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 13. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-storefronts/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-storefronts/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/building-storefronts.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (1), referenced from this skill's directory: - `references/frontend-integration.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-storefronts/references/frontend-integration.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 14. 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. - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/building-with-medusa.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (13), referenced from this skill's directory: - `reference/api-routes.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/api-routes.md - `reference/authentication.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/authentication.md - `reference/custom-modules.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/custom-modules.md - `reference/data-models.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/data-models.md - `reference/error-handling.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/error-handling.md - `reference/frontend-integration.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/frontend-integration.md - `reference/module-links.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/module-links.md - `reference/querying-data.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/querying-data.md - `reference/scheduled-jobs.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/scheduled-jobs.md - `reference/subscribers-and-events.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/subscribers-and-events.md - `reference/troubleshooting.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/troubleshooting.md - `reference/workflow-hooks.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/workflow-hooks.md - `reference/workflows.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/workflows.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 15. 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 service tooling for support staff, etc. Do NOT use for customer-facing agents (storefront chatbots, buyer-side assistants). - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/creating-internal-agents/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/creating-internal-agents.md - **Licence:** No licence detected — all rights reserved by its authors Bundled files (7), referenced from this skill's directory: - `reference/admin-extension.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/admin-extension.md - `reference/agent-setup.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/agent-setup.md - `reference/api-route.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/api-route.md - `reference/data-models.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/data-models.md - `reference/medusa-exec.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/medusa-exec.md - `reference/service.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/service.md - `reference/streaming.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/creating-internal-agents/reference/streaming.md _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 16. db-generate Generate database migrations for a Medusa module - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/db-generate/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/db-generate/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/db-generate.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 17. db-migrate Run database migrations in Medusa - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/db-migrate/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/db-migrate/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/db-migrate.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._ --- ## 18. new-user Create an admin user in Medusa - **Source:** https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/new-user/SKILL.md - **Raw:** https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/new-user/SKILL.md - **Markdown:** https://skillsdocs.com/medusajs/medusa-agent-skills/new-user.md - **Licence:** No licence detected — all rights reserved by its authors _Body withheld: no licence could be detected for this skill. Read it upstream._