using-medusa-cloud — скилл для Claude Code: деплой в Medusa Cloud
Скилл для работы с Medusa Cloud через CLI mcloud: деплой, разбор упавших сборок, окружения и переменные. Пригодится, когда агент ведёт CI/CD или чинит билд.
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a claude-codeЧто делает using-medusa-cloud
Скилл описывает, как агенту обращаться с инфраструктурой Medusa Cloud через mcloud. Внутри — правила работы с CLI и три справочных файла: setup.md для установки и авторизации, debugging-deployments.md для разбора упавших сборок, environments-and-variables.md для окружений и переменных. Агент подгружает нужный файл перед многошаговой задачей.
Логика маршрутизации по статусу деплоя простая: build-failed — смотри mcloud deployments build-logs <id>, deployment-failed — рантайм-логи через mcloud logs --deployment <id>, timed-out — сначала билд, потом рантайм. Для выбора между redeploy и trigger-build есть отдельная таблица: первое перезапускает существующую сборку, второе собирает заново из ветки.
Есть жёсткие ограничения, и они важнее всего остального. mcloud login, mcloud use без флагов и delete без --yes требуют TTY — в CI, Docker и при передаче через пайп они падают. Переменные окружения не применяются сами: после variables set нужен redeploy или trigger-build. Продакшн-окружение удалить нельзя, а --reveal не стоит передавать без прямой просьбы, потому что секреты оседают в логах терминала. Ещё --json и --follow несовместимы — для машинного разбора логов берите окно --from/--to.
Какие задачи решает
- разобрать, почему упала сборка на Medusa Cloud
- переключить контекст на нужную организацию и окружение
- применить переменные окружения после правки
- выбрать между redeploy и trigger-build
- воспроизвести build-failed локально через
mcloud local build
Примеры запросов агенту
- посмотри build-logs последнего деплоя и скажи, что сломалось
- задеплой изменения в production и проверь статус
- выстави переменную окружения и перезапусти рантайм
Как установить using-medusa-cloud
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a claude-code2Вручную: положить файлы
~/.claude/skills/using-medusa-cloud/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/using-medusa-cloud/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a codex2Вручную: положить файлы
.agents/skills/using-medusa-cloud/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a cursor2Вручную: положить файлы
.cursor/skills/using-medusa-cloud/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills using-medusa-cloud2Вручную: положить файлы
.github/skills/using-medusa-cloud/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/using-medusa-cloudВручную: положить файлы
.devin/skills/using-medusa-cloud/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о using-medusa-cloud
Как установить using-medusa-cloud в Claude?
Выполните npx skills add medusajs/medusa-agent-skills --skill using-medusa-cloud -a claude-code. Скилл окажется в ~/.claude/skills/using-medusa-cloud/SKILL.md.
Что делает using-medusa-cloud?
Учит агента управлять ресурсами Medusa Cloud через CLI mcloud: деплой, окружения, переменные, разбор логов и CI/CD.
Почему mcloud use падает в CI?
Без флагов команда интерактивная и требует TTY. Передавайте --organization, --project и --environment явно.
