# mcloud-deployments

Скилл учит агента проверять развёртывания в Medusa Cloud через CLI. Помогает находить причины падения сборок бэкенда и витрины прямо в терминале.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 установок · ★ 235
- Автор: medusajs
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/skills/mcloud-deployments

## Что делает

Скилл даёт ассистенту готовые сценарии работы с CLI `mcloud`. Он позволяет запрашивать списки релизов, фильтровать их по коммиту или типу окружения и открывать подробные карточки сборок. Агент получает доступ к выполнению команд через системный терминал вместе с утилитой `jq`.

Для точного парсинга обязательно передаётся флаг `--json`, иначе текстовый вывод может измениться и сломать разбор ответов. Если в окружении ещё не выбраны проект и организация, перед запросами вызывается `mcloud whoami --json`.

При ошибках скилл помогает читать логи сборки отдельно для бэкенда или витрины. Важно учитывать статус: если возник `deployment-failed`, логи сборки будут чистыми, потому что упал уже сам запуск сервиса, а значит, придётся смотреть логи рантайма.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/mcloud-deployments/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/mcloud-deployments/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/mcloud-deployments/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/mcloud-deployments/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install medusajs/medusa-agent-skills mcloud-deployments
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/mcloud-deployments/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-deployments
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/mcloud-deployments/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md

## Когда брать
- получить список свежих развёртываний проекта
- проверить причину ошибки при статусе `build-failed`
- отфильтровать деплои по хэшу коммита или типу окружения
- выгрузить логи сборки витрины или бэкенда

## Примеры запросов агенту
- Посмотри последние развёртывания в Medusa Cloud и найди упавшие сборки
- Выгрузи логи сборки для проблемного деплоя
- Проверь статус релиза для последнего коммита в окружении production

## Похожие
- [troubleshooting-astro-deployments](https://affpapa.org/nevibecode/skills/troubleshooting-astro-deployments.md) — скилл · 622 установки
- [managing-astro-deployments](https://affpapa.org/nevibecode/skills/managing-astro-deployments.md) — скилл · 567 установок
- [vercel-deployments-builds](https://affpapa.org/nevibecode/skills/vercel-deployments-builds.md) — скилл · 368 установок
- [vercel-deployments](https://affpapa.org/nevibecode/skills/vercel-deployments.md) — скилл · 316 установок
- [deployments-cicd](https://affpapa.org/nevibecode/skills/deployments-cicd.md) — скилл · 7 установок
- [status](https://affpapa.org/nevibecode/commands/status.md) — команда · 348 установок

Из того же набора: [medusajs/medusa-agent-skills](https://affpapa.org/nevibecode/by/medusajs/medusa-agent-skills.md) — 11 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md