mcloud-variables — скилл для Claude Code: переменные Medusa Cloud
Скилл для работы с переменными окружения Medusa Cloud через mcloud variables: список, чтение, запись, удаление и экспорт без ручного набора команд.
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a claude-codeЧто делает mcloud-variables
Скилл учит агента вызывать mcloud variables для окружения Medusa Cloud: он перечисляет переменные, достаёт одну по ключу или ID var_..., создаёт и обновляет значения, удаляет их, выгружает всё в .env. Внутри четыре команды — list, get, set, delete — и правила, как их комбинировать. Разрешены только Bash(mcloud variables*), Bash(mcloud environments*) и Bash(jq*), так что за пределы этой работы агент не выйдет.
Изменения не применяются сами. После set или delete нужен mcloud environments redeploy <env>, если переменная runtime, или mcloud environments trigger-build <env>, если build: повторный деплой берёт готовый образ и новые build-переменные не подхватит. Этот шаг легко забыть, и тогда агент отчитается об успехе, а в приложении останется старое значение.
Секреты по умолчанию маскируются. Флаг --reveal скилл запрещает, пока вы явно не попросите показать значение. Системные переменные Medusa удалить нельзя, а delete в неинтерактивном режиме требует --yes. Поиск и создание по ключу работают только при заданных --project и --environment, обращение по ID обходится без них. Для set и delete нужен mcloud CLI v0.1.10 или новее.
Какие задачи решает
- посмотреть все переменные окружения перед релизом
- залить значения из
.envв облачное окружение одной командой - найти переменную по ключу и проверить, что она не секретная
- пометить ключ как build-only и пересобрать образ
- удалить устаревший флаг и не задеть системные переменные
Примеры запросов агенту
- Покажи все runtime-переменные окружения production в JSON, системные тоже
- Заведи
REDIS_URLсо значениемredis://cache:6379и задеплой, чтобы применилось - Выгрузи переменные в
.env, значения секретов покажи — я прошу явно
Как установить mcloud-variables
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a claude-code2Вручную: положить файлы
~/.claude/skills/mcloud-variables/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcloud-variables/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a codex2Вручную: положить файлы
.agents/skills/mcloud-variables/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a cursor2Вручную: положить файлы
.cursor/skills/mcloud-variables/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills mcloud-variables2Вручную: положить файлы
.github/skills/mcloud-variables/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-variablesВручную: положить файлы
.devin/skills/mcloud-variables/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcloud-variables
Как установить mcloud-variables в Claude Code?
Выполните npx skills add medusajs/medusa-agent-skills --skill mcloud-variables -a claude-code. Скилл появится в ~/.claude/skills/mcloud-variables/SKILL.md.
Что делает mcloud-variables?
Позволяет агенту управлять переменными окружения Medusa Cloud через CLI: получать список, читать одну переменную, задавать значения, удалять их и экспортировать в .env.
Почему после изменения переменной ничего не поменялось?
set и delete только записывают значение. Для runtime-переменной нужен mcloud environments redeploy <env>, для build-переменной — mcloud environments trigger-build <env>.
