Skip to main content
affpapa.org
RU EN
skill CX Codex

mcloud-deployments — Claude Code skill: what it does, how to install

Enables agents to query Medusa Cloud deployments and inspect build logs via CLI. Useful for tracking release progress and debugging failed builds directly in the terminal.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code
Open on GitHub

What mcloud-deployments does

This skill guides the agent through mcloud deployments CLI operations. It provides clear execution patterns to list project deployments, filter by commit or environment handle, and fetch deployment details using build or deployment identifiers. The agent relies on command execution with jq for output processing.

Every query must include --json because plain text output is not guaranteed to remain stable. If organization or project contexts are missing, the agent verifies them first with mcloud whoami --json.

When a build fails, the skill pulls logs specifically for the backend or storefront stream. Note the failure status: if a deployment ends in deployment-failed instead of build-failed, build logs will be clean, so you must inspect runtime logs using mcloud logs.

What it helps with

  • list recent deployments for a project
  • inspect build logs for backend or storefront
  • filter deployment runs by commit SHA or environment
  • diagnose why a deployment status failed

Example prompts for the agent

  • Show me recent deployments for this Medusa Cloud project
  • Fetch the build logs for the latest failed deployment
  • Check if the latest commit deployed cleanly to production

How to install mcloud-deployments

1Skills CLI (Vercel)

npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code

2Manually: put the files in place

~/.claude/skills/mcloud-deployments/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcloud-deployments/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mcloud-deployments

How to install mcloud-deployments in Claude Code?

Run npx skills add medusajs/medusa-agent-skills --skill mcloud-deployments -a claude-code in your terminal.

What does the mcloud-deployments skill do?

It gives AI agents instructions for running mcloud deployments commands. It helps view deployment status, filter by commit, and inspect build output.

Why must commands always include the --json flag?

Plain text formatting in the CLI can change between releases. Using --json ensures structured output that the agent parses reliably with jq.

Similar skills

All skills for DevOps and infrastructure →
troubleshooting-astro-deployments astronomer A skill that walks the agent through diagnosing Astronomer production deployments with the Astro CLI: logs, errors, environment variables. CX Codex +1 622installs managing-astro-deployments astronomer A skill that walks your agent through Astro CLI: log in, switch workspaces, create deployments and ship code to production. CX Codex +1 567installs vercel-deployments-builds bobmatnyc Walks through the Vercel deployment lifecycle: builds, previews, release phases and rollback. Useful when you configure build output or control releases. CX Codex +1 368installs vercel-deployments devops-skills A skill for deploying frontend and full-stack apps on Vercel: previews, edge functions, environment variables and production guardrails. CX Codex +1 316installs deployments-cicd official Vercel Labs Teaches the agent Vercel deploy, promote, rollback and prebuilt build commands. Useful when you wire up a CI pipeline by hand. CX Codex GP ChatGPT 7installs status official Vercel Labs Inspects the state of a linked Vercel project, including recent deployments, domain health, and log drain setup. CX Codex GP ChatGPT 348installs

From the same set12

building-storefronts A skill for building Medusa storefronts: it tells the agent how to call APIs through the SDK and React Query without breaking requests. CX Codex +1 4,200installs db-generate Generates database migrations for a Medusa module and tells you what to run next. CX Codex +1 3,400installs learning-medusa An interactive tutoring skill that guides you through Medusa architecture step by step with hands-on checkpoints. CX Codex +1 3,400installs using-medusa-cloud A skill that teaches an agent to run Medusa Cloud through the mcloud CLI: deploys, failed builds, environments, variables. Useful for CI/CD work. CX Codex +1 1,400installs mcloud-organizations This skill lets your agent run mcloud organizations commands: list Cloud organizations, resolve an ID by name, pull subscription and member details. CX Codex +1 1,300installs mcloud-logs A skill that teaches your agent to read backend and storefront logs with mcloud logs, filter them by time or deployment, and pipe them to JSON. CX Codex +1 1,300installs mcloud-projects Runs Medusa Cloud CLI commands to inspect and delete projects. Useful when managing cloud deployments and switching active project handles. CX Codex +1 1,300installs mcloud-variables An agent skill that drives mcloud variables for Medusa Cloud environments: list keys, read one, write, delete, export to .env. CX Codex +1 1,300installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor