M

Skills Medusajs

building-admin-dashboard-customizations
medusajs
Пользовательские расширения интерфейса для панели администратора Medusa с использованием Admin SDK и компонентов Medusa UI. Загружайте этот навык ПЕРВЫМ для любой работы с интерфейсом администратора (планирование, реализация, исследование); MCP-серверы предоставляют только справочную информацию по API, но не шаблоны проектирования или стратегии загрузки данных. ВАЖНО: Всегда используйте Medusa JS SDK для всех API-запросов (никогда обычный fetch); разделяйте запросы отображения и модальные запросы, а также сбрасывайте данные отображения после мутаций. Реализуйте виджеты на существующих страницах или создавайте пользовательские маршруты интерфейса;...
official
building-admin-dashboard-customizations
medusajs
Load automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation).…
official
building-storefronts
medusajs
SDK-ориентированная интеграция фронтенда для витрин Medusa с паттернами React Query и критическими правилами вызова API. Всегда используйте Medusa JS SDK для всех API-запросов — никогда не используйте обычный fetch(), так как он не содержит необходимых заголовков (публикуемый API-ключ для маршрутов витрины, аутентификация для маршрутов администратора). Передавайте простые объекты JavaScript в методы SDK; никогда не используйте JSON.stringify() для параметров тела, так как SDK автоматически обрабатывает сериализацию. Используйте useQuery для GET-запросов и useMutation для POST/DELETE-запросов,...
official
building-storefronts
medusajs
Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns,…
official
building-with-medusa
medusajs
Всестороннее руководство по архитектуре бэкенда Medusa, рабочим процессам и критически важным правилам реализации. Охватывает шесть категорий правил (архитектура, типобезопасность, размещение бизнес-логики, импорты, доступ к данным, организация файлов) с конкретными антипаттернами и проверками соблюдения. Обеспечивает строгое разделение уровней: Модуль → Рабочий процесс → API-маршрут → Фронтенд, при этом рабочие процессы обязательны для всех мутаций, а разрешены только HTTP-методы GET/POST/DELETE. Включает критические правила обработки данных: цены хранятся как есть...
official
building-with-medusa
medusajs
Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links,…
official
creating-agents-in-medusa
medusajs
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…
official
db-generate
medusajs
Генерирует миграции базы данных для модулей Medusa одной командой. Обёртка для CLI-команды npx medusa db:generate, создающая файлы миграций для указанных модулей Medusa. Принимает имя модуля в качестве аргумента и сообщает расположение файла миграции, ошибки и дальнейшие шаги. Автоматически предлагает выполнить npx medusa db:migrate после генерации для применения миграций.
official
db-generate
medusajs
Generate database migrations for a Medusa module
official
db-migrate
medusajs
Выполнить ожидающие миграции базы данных Medusa и сообщить результаты. Запускает npx medusa db:migrate через Bash для применения всех ожидающих миграций к базе данных Medusa. Сообщает результаты миграции, включая количество применённых миграций, любые возникшие ошибки и подтверждение успеха. Разработано для проектов Medusa со стандартной настройкой npm/npx.
official
db-migrate
medusajs
Run database migrations in Medusa
official
diagnosing-dependabot-alerts
medusajs
Diagnoses GitHub Dependabot / security alerts in the Medusa monorepo and finds the least-invasive fix. Use when investigating a Dependabot alert, security…
official
learning-medusa
medusajs
Интерактивный пошаговый учебный курс по разработке Medusa, в рамках которого вы создаёте функцию брендов, изучая архитектурные шаблоны. Три последовательных урока (всего 2–3 часа), охватывающих модули, рабочие процессы, маршруты API, связи модулей, хуки рабочих процессов и настройку административного интерфейса. Проверка контрольных точек после каждого крупного компонента тестирует понимание концепций, качество кода и функциональность перед продолжением. Ошибки рассматриваются как возможность для обучения; отладка проводится совместно с диагностическими вопросами и анализом первопричин...
official
learning-medusa
medusajs
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").…
official
mcloud-deployments
medusajs
Execute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment…
official
mcloud-deployments
medusajs
Выполнять команды mcloud deployments для вывода списка развертываний, получения сведений о развертывании и загрузки журналов сборки. Используйте при выводе списка развертываний, проверке развертывания…
official
mcloud-environments
medusajs
Выполнять команды mcloud environments для вывода списка, получения, создания, удаления, повторного развертывания или запуска сборок для Cloud-сред. Используйте при управлении жизненным циклом среды,…
official
mcloud-environments
medusajs
Execute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle,…
official
mcloud-local
medusajs
Выполнить локальную сборку mcloud для воспроизведения облачной сборки на локальной машине. Использовать при отладке развертывания с неудачной сборкой без отправки в отслеживаемую ветку,…
official
mcloud-logs
medusajs
Выполнить mcloud logs для получения и потоковой передачи журналов выполнения для облачных сред. Используйте при чтении журналов бэкенда или витрины, фильтрации по временному диапазону, поиске…
official
mcloud-logs
medusajs
Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching…
official
mcloud-organizations
medusajs
Выполнять команды mcloud organizations для вывода списка или получения облачных организаций. Используется при обнаружении организаций, разрешении идентификаторов организаций по имени или получении…
official
mcloud-organizations
medusajs
Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving…
official
mcloud-projects
medusajs
Выполнять команды mcloud projects для вывода списка, получения или удаления облачных проектов. Используется при обнаружении проектов, разрешении дескрипторов проектов по имени или получении…
official
mcloud-projects
medusajs
Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving…
official
mcloud-variables
medusajs
Выполнение команд mcloud variables для вывода и получения переменных окружения для облачной среды. Используется при проверке, чтении или экспорте переменных окружения…
official
mcloud-variables
medusajs
Execute mcloud variables commands to list, get, set, and delete environment variables for a Cloud environment. Use when inspecting, reading, creating,…
official
new-user
medusajs
Создать нового администратора в Medusa с email и паролем. Принимает email и пароль как аргументы команды для установки учетных данных администратора. Выполняет команду npx medusa user через Bash с флагами -e и -p. Сообщает об успешном создании, email пользователя, ошибках и следующих шагах для входа в панель администратора.
official
new-user
medusajs
Create an admin user in Medusa
official
reviewing-prs
medusajs
Reviews GitHub pull requests for the Medusa repository. Checks PR template compliance, contribution guidelines, code conventions, security, performance, and…
official
storefront-best-practices
medusajs
Всестороннее руководство по созданию современных ecommerce-витрин с паттернами, компонентной архитектурой и интеграцией с бэкендом. Охватывает все компоненты витрины: навигацию, страницы товаров, корзину, оформление заказа и страницы аккаунта в любом фреймворке (Next.js, SvelteKit, React, Vue). Включает критически важные паттерны доступности (aria-live для обновлений корзины), мобильную оптимизацию (safe-area-inset, цели касания 44px) и требования SEO (схема Product, Core Web Vitals). Предоставляет обязательный бэкенд SDK...
official
storefront-best-practices
medusajs
ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart,…
official
triaging-issues
medusajs
Triages GitHub issues for the Medusa repository. Use when a GitHub issue is opened or receives a new comment. Categorizes the issue, validates it, and emits a…
official
triaging-issues
medusajs
Выполняет триаж задач GitHub для репозитория Medusa. Используется, когда открыта задача GitHub или получен новый комментарий. Категоризирует задачу, проверяет её и отправляет…
official
using-medusa-cloud
medusajs
Управляет ресурсами Medusa Cloud через Cloud CLI (mcloud). Используйте при развертывании, отладке развертываний, управлении окружениями, переменными окружения или любыми…
official
using-medusa-cloud
medusajs
Manages Medusa Cloud resources through the Cloud CLI (mcloud). Use when deploying, debugging deployments, managing environments, environment variables, or any…
official
writing-docs
medusajs
Writes and updates Medusa documentation MDX files for the book, resources, ui, user-guide, and cloud projects. Use when making documentation changes based on…
official
writing-releases
medusajs
Writes GitHub release notes for Medusa releases in the established style. Use when generating a draft release description from a list of commits and PR…
official
writing-tsdocs
medusajs
Adds and updates TypeDoc (TSDoc) comments to TypeScript source files in the Medusa codebase. Covers HTTP types, API routes, UI components, data models, service…
official