mcloud-projects — Claude Code skill: what it does, how to install
Runs Medusa Cloud CLI commands to inspect and delete projects. Useful when managing cloud deployments and switching active project handles.
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a claude-codeWhat mcloud-projects does
This skill teaches your assistant to control Medusa Cloud projects directly through the terminal. It relies on mcloud projects, mcloud use, and jq to run queries and extract structured JSON data.
The agent can run mcloud projects list across organizations or fetch single project records with mcloud projects get. Returned payloads include project identifiers, handles, deployment regions, and environment arrays. It can also pipe data through jq to update the active CLI target with mcloud use.
Deleting a project with mcloud projects delete is permanent. Because removal destroys all linked environments and deployments, the agent must pass --yes in non-interactive pipelines. Double-check your project handle before running it.
What it helps with
- find a project handle by store name
- list cloud projects and inspect linked environments
- switch active context using
mcloud use - delete a cloud project without interactive prompts
Example prompts for the agent
- Find the handle for project My Store in org_123 and set it as active using mcloud use
- Show all projects and linked environments in organization org_123
- Delete project old-project in org_123 using the non-interactive flag
How to install mcloud-projects
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a claude-code2Manually: put the files in place
~/.claude/skills/mcloud-projects/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcloud-projects/
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a codex2Manually: put the files in place
.agents/skills/mcloud-projects/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a cursor2Manually: put the files in place
.cursor/skills/mcloud-projects/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills mcloud-projects2Manually: put the files in place
.github/skills/mcloud-projects/SKILL.md1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a gemini-cli2Platform CLI
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-projectsManually: put the files in place
.devin/skills/mcloud-projects/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcloud-projects
How do I install mcloud-projects in Claude Code?
Run npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a claude-code in your terminal.
What does mcloud-projects do?
It provides execution instructions for Medusa Cloud CLI project commands. The agent can list cloud instances, inspect environment details, and delete obsolete projects.
Is project deletion reversible?
No, running mcloud projects delete permanently removes the project along with its deployments and linked environments. Non-interactive scripts require the --yes flag to proceed.