mcloud-local — скилл для Claude Code: локальная сборка
Скилл запускает локальную сборку Medusa Cloud через mcloud local build. Он пригодится, чтобы воспроизвести ошибку сборки или проверить переменные без отправки изменений в ветку.
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a claude-codeЧто делает mcloud-local
mcloud-local помогает повторить сборку Cloud на своей машине. Скилл может найти неудачный деплой, определить собранный для него коммит и переключить Git на него. Результат mcloud local build нужно проверять по коду завершения: команда выводит обычный текст, а не JSON.
Можно собрать backend или передать --type storefront, проверить переменную через --var KEY=VALUE либо загрузить значения из .env с --env-file .env. Docker-кеш выключен по умолчанию; --docker-cache включает его. Для работы нужны запущенный Docker и каталог внутри Git-репозитория. Скилл помогает с ошибками сборки, но не сбоев запущенного приложения: для runtime-ошибок в тексте приведена команда mcloud logs --deployment <id>.
Какие задачи решает
- воспроизвести локально неудачную Cloud-сборку
- проверить сборку backend или storefront
- проверить исправление переменной сборки без правки кода
- найти шаг, на котором завершается сборка с ошибкой
Примеры запросов агенту
- Повтори локально сборку для коммита, на котором упал деплой.
- Собери storefront из
apps/storefrontкомандойmcloud local build --type storefront --storefront-path apps/storefront. - Проверь сборку с
NODE_ENV=productionчерезmcloud local build --var NODE_ENV=production.
Как установить mcloud-local
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a claude-code2Вручную: положить файлы
~/.claude/skills/mcloud-local/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcloud-local/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a codex2Вручную: положить файлы
.agents/skills/mcloud-local/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a cursor2Вручную: положить файлы
.cursor/skills/mcloud-local/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills mcloud-local2Вручную: положить файлы
.github/skills/mcloud-local/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-localВручную: положить файлы
.devin/skills/mcloud-local/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcloud-local
Как установить mcloud-local в Claude Code?
Выполните npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a claude-code. Файл скилла находится по пути ~/.claude/skills/mcloud-local/SKILL.md.
Что делает mcloud-local?
Он запускает локальную сборку Medusa Cloud через mcloud local build и помогает воспроизвести ошибку сборки на нужном коммите.
Что нужно для работы mcloud-local?
Нужны установленный и запущенный Docker, а также Git-репозиторий проекта. Скилл предназначен для ошибок сборки, не для runtime-сбоев.
