mcloud-deployments — скилл для Claude Code: разбор и установка
Скилл учит агента проверять развёртывания в Medusa Cloud через CLI. Помогает находить причины падения сборок бэкенда и витрины прямо в терминале.
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-codeЧто делает mcloud-deployments
Скилл даёт ассистенту готовые сценарии работы с CLI mcloud. Он позволяет запрашивать списки релизов, фильтровать их по коммиту или типу окружения и открывать подробные карточки сборок. Агент получает доступ к выполнению команд через системный терминал вместе с утилитой jq.
Для точного парсинга обязательно передаётся флаг --json, иначе текстовый вывод может измениться и сломать разбор ответов. Если в окружении ещё не выбраны проект и организация, перед запросами вызывается mcloud whoami --json.
При ошибках скилл помогает читать логи сборки отдельно для бэкенда или витрины. Важно учитывать статус: если возник deployment-failed, логи сборки будут чистыми, потому что упал уже сам запуск сервиса, а значит, придётся смотреть логи рантайма.
Какие задачи решает
- получить список свежих развёртываний проекта
- проверить причину ошибки при статусе
build-failed - отфильтровать деплои по хэшу коммита или типу окружения
- выгрузить логи сборки витрины или бэкенда
Примеры запросов агенту
- Посмотри последние развёртывания в Medusa Cloud и найди упавшие сборки
- Выгрузи логи сборки для проблемного деплоя
- Проверь статус релиза для последнего коммита в окружении production
Как установить mcloud-deployments
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code2Вручную: положить файлы
~/.claude/skills/mcloud-deployments/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcloud-deployments/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a codex2Вручную: положить файлы
.agents/skills/mcloud-deployments/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a cursor2Вручную: положить файлы
.cursor/skills/mcloud-deployments/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills mcloud-deployments2Вручную: положить файлы
.github/skills/mcloud-deployments/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-deploymentsВручную: положить файлы
.devin/skills/mcloud-deployments/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcloud-deployments
Как установить mcloud-deployments в Claude Code?
Выполните команду npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code в терминале.
Что делает скилл mcloud-deployments?
Он обучает агента выполнять команды mcloud deployments, просматривать историю релизов и читать журналы сборки. Это упрощает поиск ошибок при подготовке бэкенда или витрины.
Зачем при вызове команд всегда передавать флаг --json?
Текстовый вывод CLI может меняться со временем. Флаг --json гарантирует стабильную структуру данных для утилиты jq и надёжного парсинга агентом.
