skill CX Codex

mcloud-local — Claude Code skill for local builds

Q: How do I install mcloud-local in Claude Code?

Run `npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a claude-code`. The skill file is at `~/.claude/skills/mcloud-local/SKILL.md`.

Q: What does mcloud-local do?

It runs a Medusa Cloud build on your machine with `mcloud local build`, helping you reproduce a build failure at the relevant commit.

Run a Medusa Cloud build on your machine with mcloud local build. Use the skill to investigate a failed build or test build-variable changes before pushing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

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

Open on GitHub

What mcloud-local does

mcloud-local helps reproduce a Cloud build locally. It can identify a failed deployment, find its commit, and check out that revision in Git. The command reports progress as plain text, so use its exit status to tell whether the build passed; its output is not JSON.

Build the backend by default, or choose the storefront with --type storefront. Test a variable with --var KEY=VALUE, or supply a local file using --env-file .env. Docker caching starts disabled; --docker-cache turns it on. Docker must be installed and running, and the command must run from inside the project's Git repository. This skill covers build failures, not runtime failures; the instructions direct runtime debugging to mcloud logs --deployment <id>.

What it helps with

reproduce a failed Cloud build locally
build the backend or storefront
test a build-variable change without editing code
identify the step that caused a build to fail

Example prompts for the agent

Reproduce the failed deployment's build at its commit.
Build the storefront from apps/storefront with mcloud local build --type storefront --storefront-path apps/storefront.
Test the build with NODE_ENV=production using mcloud local build --var NODE_ENV=production.

How to install mcloud-local

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

1Skills CLI (Vercel)

npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a codex

2Manually: put the files in place

.agents/skills/mcloud-local/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a cursor

2Manually: put the files in place

.cursor/skills/mcloud-local/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install medusajs/medusa-agent-skills mcloud-local

2Manually: put the files in place

.github/skills/mcloud-local/SKILL.md

1Skills CLI (Vercel)

npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a gemini-cli

2Platform CLI

gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-local

Manually: put the files in place

.devin/skills/mcloud-local/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a opencode

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

Questions about mcloud-local

How do I install mcloud-local in Claude Code?

Run npx skills add medusajs/medusa-agent-skills --skill mcloud-local -a claude-code. The skill file is at ~/.claude/skills/mcloud-local/SKILL.md.

What does mcloud-local do?

It runs a Medusa Cloud build on your machine with mcloud local build, helping you reproduce a build failure at the relevant commit.

What do I need to run mcloud-local?

Docker must be installed and running, and you must be inside the project's Git repository. The skill addresses build failures, not runtime failures.

wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. CX Codex +1 1,300,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. CX Codex 214,439installs orca-cli stablyai The skill lets an agent manage Orca worktrees, terminals, artifacts and the built-in browser through the orca CLI. Useful when your work already runs inside Orca. CX Codex +1 353,600installs

From the same set14

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-environments Manage mcloud environments from your agent: inspect, create, or remove them, then rerun a deployment or start a fresh build. Useful when changing environment settings or shipping committed code. 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 mcloud-deployments 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. CX Codex +1 1,300installs