building-with-medusa — скилл для Claude Code: суть и установка
Скилл задаёт правила бэкенд-разработки на Medusa: от связей модулей до шагов воркфлоу. Помогает агенту не ломать архитектуру при создании API и моделей.
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a claude-codeЧто делает building-with-medusa
Скилл регламентирует разработку серверной части Medusa по жёсткой цепочке: модуль с CRUD-операциями, воркфлоу с мутациями и откатом, API-маршрут и клиентский интерфейс. Любые изменения данных выполняются строго через шаги воркфлоу. Вызывать сервисы модулей напрямую из маршрутов запрещено.
Внутри собраны правила шести категорий: изоляция модулей, типизация, размещение логики, структура файлов и доступ к данным. Скилл требует импортировать Zod строго из @medusajs/framework/zod, так как проект перешёл на Zod v4 с версии v2.14.0. Для маршрутов допустимы только методы GET, POST и DELETE.
Цены в Medusa хранятся напрямую как 49.99, а не в центах. Если агент умножит цену на 100 или разделит при выводе, логика расчётов сразу разойдётся с базой. Перед кодингом агент обязан загружать отдельные справочники из папки reference/.
Какие задачи решает
- построить воркфлоу мутаций с поддержкой отката
- создать API-маршрут с валидацией через Zod v4
- настроить связь между изолированными модулями
- выбрать между
query.graph()иquery.index()для выборки данных
Примеры запросов агенту
- Создай кастомный модуль для подписок и свяжи его с заказами через link.
- Напиши воркфлоу для обновления статуса доставки с валидацией прав.
- Добавь POST-маршрут в админку с проверкой тела запроса через AuthenticatedMedusaRequest.
Как установить building-with-medusa
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a claude-code2Вручную: положить файлы
~/.claude/skills/building-with-medusa/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/building-with-medusa/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a codex2Вручную: положить файлы
.agents/skills/building-with-medusa/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a cursor2Вручную: положить файлы
.cursor/skills/building-with-medusa/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills building-with-medusa2Вручную: положить файлы
.github/skills/building-with-medusa/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-dev/skills/building-with-medusaВручную: положить файлы
.devin/skills/building-with-medusa/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора11
Похожие
Рядом в теме «Бэкенд и API»
Всё по теме «Бэкенд и API» →Вопросы о building-with-medusa
Как установить building-with-medusa в Claude Code?
Запустите команду npx skills add medusajs/medusa-agent-skills --skill building-with-medusa -a claude-code. Также можно вручную поместить файл по пути ~/.claude/skills/building-with-medusa/SKILL.md.
Что делает скилл building-with-medusa?
Он передаёт ИИ-ассистенту архитектурные правила бэкенда Medusa, включая запрет прямых вызовов сервисов из роутов и работу с Zod v4.
Как скилл предписывает работать с ценами в Medusa?
Цены записываются в базу в исходном виде с плавающей точкой, например 49.99. Скилл запрещает умножать суммы на 100 при сохранении или делить на 100 перед выводом.
